Comments (11)
Hi @colachg,
It should be possible to arrange that. The question is where and how to do it.
Are you interested in README.md
translation only, or also comments in source code?
@rust-embedded/resources I think it would make sense to keep a translation under the WG, what do you think?
Approaches I can think of is:
- Add a
README.md.cn
version to each tutorial (works only if onlyREADME.md
is to be translated). - Have a
chinese
branch to runs in parallel tomaster
. This way source code comments could also be translated.
from rust-raspberrypi-os-tutorials.
I think README.md
is enough and source code comment is not necessary. Sometimes translator works better. People should know what we are doing, how to do it and why it should be this.
Maybe there should be another voice :)
from rust-raspberrypi-os-tutorials.
@colachg That's a great idea. I think the only obstacles here are technical ones, like:
- How to present it
- How to verify the correctness (only very few of us read Mandarin, probably close to none 😅)
- How to maintain it, i.e. make sure that updates to the English version are reflected in the Chinese version
from rust-raspberrypi-os-tutorials.
I think README.md is enough and source code comment is not necessary.
Great. In that case, adding a README.CN.md
to the repository on master
will probably ensure the best visibility.
We can also add to the repo's main README.md a hint about their existence.
How to maintain it, i.e. make sure that updates to the English version are reflected in the Chinese version
This is rather difficult I guess. I can try to ping people when I do updates to the english version.
from rust-raspberrypi-os-tutorials.
This is rather difficult I guess. I can try to ping people when I do updates to the english version.
I have two ideas:
-
Open a channel and add bots to ping and do some routines. (I think
discord
is good) -
Forking another project to do Chinese version and adding the reference to the
README.md
onmaster
. Let volunteers(like me) to do the left things.
from rust-raspberrypi-os-tutorials.
This is rather difficult I guess. I can try to ping people when I do updates to the english version.
I have two ideas:
* Open a channel and add bots to ping and do some routines. (I think `discord` is good) * Forking another project to do Chinese version and adding the reference to the `README.md` on `master`. Let volunteers(like me) to do the left things. * https://github.com/ColaPi/rust-raspi3-OS-tutorials
I can help review the translations in my free time.
from rust-raspberrypi-os-tutorials.
I think forking would reduce visibility quite some. How about having a working branch for Chinese, where you can maintain a README.cn.md through pull requests. I could then, from time to time, also sync finished versions to master as well.
from rust-raspberrypi-os-tutorials.
I think forking would reduce visibility quite some. How about having a working branch for Chinese, where you can maintain a README.cn.md through pull requests. I could then, from time to time, also sync finished versions to master as well.
I think it's a good idea, but I'm not sure if we can update the Chinese version as soon as master updates.
from rust-raspberrypi-os-tutorials.
from rust-raspberrypi-os-tutorials.
Sounds great! We can merge a PR whenever either @readlnh or @colachg has approved a PR of the respective other party. Since nobody in the WG can proof-read themselves, I think that's the straight forward way for now.
from rust-raspberrypi-os-tutorials.
Decision has been made and this activity has started now. Closing this issue 👍
from rust-raspberrypi-os-tutorials.
Related Issues (20)
- invalid file operation error HOT 3
- error[E0463]: can't find crate for `core` HOT 2
- Complete Chinese Translation HOT 3
- I want to know about other microcontrollers, you can refer to this example HOT 3
- Pure rust chainboot HOT 1
- Cannot start to work with this repo
- error: linker `cc` not found [Makefile:123: target/aarch64-unknown-none-softfloat/release/kernel] Error 101 HOT 1
- chapter 6 can not get correct output, stuck at: [ML] Requesting binary HOT 1
- everything seems to work fine but I cant input anything HOT 3
- Miniterminal not working on Raspberry pi 4 HOT 1
- ICR management question
- Error regarding Github CI/CD HOT 3
- Depracated link in The tl;dr Version subsection of README.md file HOT 2
- Invalid links in 11_exceptions_part1_groundwork/README.md HOT 2
- Consider generating these documents into a website
- Plans for even more embedded devices
- Please Change README HOT 2
- Why use Makefile handle build process? HOT 1
- Currently porting to RISC-V
- What determines the value of GPIO_PUP_PDN_CONTR_REG ?
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from rust-raspberrypi-os-tutorials.