How to contribute?

[crownpku]

I'm Chinese and would like to contribute to the keras docs-zh translation.
Is there any ways that we can help and share the task? Thanks.

[BIGBALLON]

I'm Chinese and I have the same question !

[fchollet]

You can submit a PR translating a file in sources/ (or part of a file). Files should be translated in-place (i.e. you just edit the file).

[ypwhs]

Maybe you can reference this repository: https://github.com/MoyanZitto/keras-cn/

[MaxPoon]

We need to wait for the conventions to be set before translating the doc, right?

[gaussic]

You can fork the code and commit your translations, and then make a new pull request.

[MaxPoon]

@gaussic I meant we don't have the conventions to follow if we start translating now.

[fchollet]

Feel free to make up the conventions as you go. When you settle on appropriate terms, please update the README, so that others can be on the same page.

[gaussic]

I've just read the conventions from the fchollet/keras-docs-ja repo. Maybe we could make a Chinese version like this.

Keras documentationの日本語訳化

翻訳ガイドライン

• 翻訳対象は本文とコード中のコメント
• 本文は敬体（です・ます調）
• 句読点は「，．」を用いる
• 引用符（'，"）は基本的にそのまま
• 記号「，．（）？！：；」は全角
• 文中のシンタックスハイライト（syntax highlight）の前後に空白は入れない．
• 用語の訳は対訳表に従う．

※ 翻訳は英語から日本語へのただの変換作業ではなく，英文の意味を読み取り，日本語として表現する創作作業です．
英語の言い回しに引きずられることなく自然な日本語で表現しましょう．

I mean it's not difficult.

[MoyanZitto]

@fchollet

Well, I've already translated keras docs into Chinese, see http://keras-cn.readthedocs.io/en/latest/

[SCP-173-cool]

@fchollet
http://keras-cn.readthedocs.io/en/latest/

[fchollet]

@MoyanZitto would you like to move the contents to keras.io?

[tarvos21]

@fchollet Does the contributor need to reserve the original English text and put Chinese text under English text, or replace English text with Chinese text directly?

[MoyanZitto]

@fchollet
The CN version of keras docs contains not only all contents of keras.io but also some application advice. I re-organize the contents for better display, so it I need to make many modifications to fit the offered file structure( also some relative links need to be modified).
It may take some time....
How about just add a link on keras.io to keras-cn.io？I'll keep updating it.

[MoyanZitto]

@fchollet
of course， if you want to manage all keras-cn/jp/xxx docs and offer them in some unified way. I'd like to commit my docs to this repo.

[fchollet]

@tarvos21 the translation should be in-place, so the English content should be deleted and replaced with Chinese content.

@MoyanZitto that's great, please create PR(s) in this repo. For the time being the way to upload docs to keras.io will be via collaborative repos like this one. But if you have suggestions for a different setup, I'm listening.