Mobx中文文档讨论专用issue

[iChenLei]

📖 欢迎在此issue留言讨论任何Mobx中文文档翻译相关的问题

[WanderWang]

我已经开始了 #1 的翻译，在 issue 列表里没有找到，请创建一个，谢谢

[Neo42]

https://mobx.js.org/getting-started 这个文档需要翻译吗，@iChenLei？可以的话我想认领这部分。

[iChenLei]

@Neo42 可以，你先提PR吧 我晚点建一个issue 好像是我看漏了
这个页面是一个HTML https://github.com/mobxjs/zh.mobx.js.org/blob/main/website/static/getting-started.html

[Neo42]

PR已提 #52

[ObservedObserver]

对于一些概念的翻译是保留英文还是使用中文？如果使用中文，是不是需要做一个专有名词列表来统一规范翻译，避免同一个概念被使用了不同的名称。比如observable，derivation，reaction

[iChenLei]

感觉保留英文更好一点，直观点

最近会开始合并已经校对一段时间的翻译文档，我工作太忙了，对不住各位译者:cry:

[Cyberhan123]

对于一些概念的翻译是保留英文还是使用中文？如果使用中文，是不是需要做一个专有名词列表来统一规范翻译，避免同一个概念被使用了不同的名称。比如observable，derivation，reaction

我在翻译的时候保留了部分英文内容或者携带了括号，我觉得这是一个好办法

[Neo42]

排版规范是不是也应该定一下？毕竟是官方文档😅。主要是标点符号、空格和中英文混排的格式需要注意一下。

可以参考这个技术文档写作规范和 W3C 的中英文混排规范

[iChenLei]

@Neo42 明天

edit: 规范可以定，但是我觉得标点符号、空格和中英文混排的格式这些应该由lint工具或者脚本来规范，也就是翻译内容都提交之后的善后工作，这个点 @WanderWang 有说过，不是太愿意在翻译阶段纠结一些细小的格式问题。#1 (comment)

[Neo42]

edit: 规范可以定，但是我觉得标点符号、空格和中英文混排的格式这些应该由lint工具或者脚本来规范，也就是翻译内容都提交之后的善后工作，这个点 @WanderWang 有说过，不是太愿意在翻译阶段纠结一些细小的格式问题。#1 (comment)

@iChenLei 好的

[iChenLei]

我认为应该在翻译过程中内置一个脚本，通过 git 钩子的方式来保证规范，而不是要求翻译者自行遵循规范。具体的钩子逻辑我尝试采用 NodeJS 编写一个，但是钩子本身和 github 的工作流这一块我并没有做过，可能需要其他人来协助

@WanderWang 请问你的NodeJS脚本可以提供一下吗？给一个gist代码段也可以，Github Actions这边我可以试一下。

[Neo42]

请问首页需要翻译吗？ @iChenLei

[iChenLei]

@Neo42 可以，你翻译好了 我可以快速校对合并 后续我会在上面改一些东西，感谢 :)

[wuxyman]

@iChenLei 要翻译的内容全都有认领了？希望可以参与贡献