Comments (17)
@gaearon There is no disagreement.
We can collaborate under https://github.com/reactjs/cn.reactjs.org.
The bot and auto-sync with official doc would also be helpful.
We'll try to merge the content of this repo to the newest version.
And we already have our translator team, once we got the authority it would be helpful for us to add people to collaborate.
from react.
That sounds great, how should we proceed?
from react.
Thanks for replying!
For now, I can think of two things:
- Sync this fork with the original repository (reactjs/reactjs.org), making sure that logic and formatting are consistent (I can help with this).
- Ensure that the following sections are translated and up-to-date with the current React docs:
- Home page
- Tutorial
- Main Concepts
- API
There are other issues (in particular, making sure that anchor names for headings are consistent, but those can wait until changes to the main reactjs.org repository.
Again, thank you so much for the help!
from react.
I was thinking that maybe it would be a good idea to start a fresh fork from current English master, and apply translations on top on a file-by-file basis (while checking that they match the content). If some pages have changed significantly, leave them in English so we can come back to them in another pass.
from react.
As @gaearon mentioned, I think we'd rather start with a new fork instead (Dan already set one up at https://github.com/reactjs/cn.reactjs.org).
Doing this has the advantage of:
- Allowing us to cherry-pick commits to make sure everything is up to date.
- Making sure we don't lose recent website changes.
- Making sure that translations don't "roll back", i.e. we don't replace "Hello World" with a translated version of it from two years ago.
from react.
Hi I am Lee from Tencent. A few friends and I had a side project docschina to help localize tech docs. We have run our docs translation team for two years. We have help webpack, rollup, parcel to build their Chinese docs. From our experience, it is hard to keep the docs up to date and it is sometimes hard for Chinese developers to reach the site because github and github pages are usually not stable in China.
My suggestion is that we can use part of the translation content from this repo and start a new one.
We have created one: https://github.com/docschina/cn.reactjs.org. Then we should also deploy a localized copy purely for Chinese developers like webpack, rollup and etc.
from react.
We have this Chinese official docs for a long time.
from react.
The problem is that our contributors have synced the content between this repo and the official one manually, but the rest files maybe out-dated. And there are also hard-coded content in the src
website templates.
I think we should start with the newest official repo, and try to diff the contents file by file.
As @lcxfs1991 mentioned, we've set up a Chinese version doc site for a long time, maybe we can just resolve the cn.reactjs.org
domain to it and work with the updates at the same time.
from react.
I don’t understand which parts of the proposal you’d like to do differently. Can you explain in more detail?
We thought it would make most sense to:
- Keep the fork in ReactJS GitHub org
- You would be owners of that fork
- You would move content from this repo into that fork page by page, verifying it’s up-to-date
- We would set up a bot that would help you stay up to date by sending PRs and issues
- There could still be another mirror site for network connectivity with China
Which parts do you disagree with? We could do it differently. But I’m not sure I understand what it is that you propose to change. Thanks!
from react.
I don’t mind making a repository in another org (e.g. docschina) the official one instead of one in our org (reactjs). Can you explain why this is better?
My concerns are:
- I want website source to match our latest master
- I want to make sure translated docs match current content and aren’t old
I thought it would be easier to enforce if we move everything into our repo page by page. You will have full control over the repo itself.
But if you want to keep it in docschina org that’s also fine. Please let me know what works better for you.
from react.
Amazing. If there’s anything we can help you with, let us know!
from react.
@discountry Who should I add to the team?
from react.
Looks like work started in reactjs/zh-hans.react.dev#3
from react.
@gaearon Yeah, Please add @discountry , @lcxfs1991 , @hijiangtao and @dear-lizhihua. THX!
from react.
@gaearon Oh, I think the issue of organizing people should be controlled by us. There shouldn’t be too many people, otherwise it will be inconvenient.THX!
from react.
I have sent the invitations, you should have access now after you accept them.
from react.
@gaearon Oh, that’s great. THX!
from react.
Related Issues (20)
- StrictMode 笔误
- 代码缩进引起误解 HOT 2
- https证书过期 HOT 1
- https://github.com/discountry/react/blob/master/content/blog/2018-08-01-react-v-16-4-2.md HOT 1
- https://github.com/discountry/react/blob/master/content/blog/2018-06-07-you-probably-dont-need-derived-state.md HOT 1
- https://github.com/discountry/react/blob/master/content/blog/2018-05-23-react-v-16-4.md HOT 1
- 已认领
- The indent of the first line code in almost every code block is still there. HOT 1
- Translation
- https://github.com/Jemair/react/blob/master/content/docs/hooks-intro.md
- The main page can't open correctly HOT 1
- https://github.com/discountry/react/blob/master/content/docs/hooks-effect.md
- falsy => false HOT 1
- 示例代码首行缩进的解决办法 HOT 6
- React 中文官网BUG!!! HOT 2
- 中文翻译有一个错字
- Why chines HOT 1
- 【React源码专题文章推荐】专注于React源码解析的文章
- 怎么查看以前的react文档版本啊 想要看看以前的版本文档 HOT 3
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 react.