- 本项目使用 markdown 语法编写。请保证该语法的正确性。
- 所有文件及路径的创建应该由 ykla 来完成。如果没有你要翻译的条目，请提出 issue。
- 所有人名和特殊的专有名词均应该列入“词汇表”。
- 请在提交前在 issue 提交自己的规划避免重复工作。
树莓派官方文档实际上基本上不会变化，只有在每个版本发行后的半年内才会经常变动。如果你看到他有很多提交甚至有几千个，但是实际上他一个字也没动，就是可能把顺序改了。而且每次只改几个字。
为了对付这种行为对译者的影响，建议你使用以下方法追踪上游更新：
- 原文从哪获取？ 首先，文档原文来源应该来自官方文档页面，而非直接对着 Github 的 adoc 文档进行翻译，那样你是对付不了他的，他一天能提交上百次，你能吗？而且他默认分支是
develop，你翻译该分支也是错误的，应该是翻译master，因为根据官方构建指南，官方文档页面是从master分支生成的。 - 如何追踪或同步上游更新？ 最简单的办法是，直接复制网页，粘贴到 Markdown 软件里，本项目使用的是思源笔记，如果表格错乱，你可以用 Marktext 代替之。对于该操作，Typora、Obsidian 均表现不佳，对于该项目应该优先选用思源笔记，少部分项目必须使用 Marktext 才能达到效果。然后将每个页面存起来，下次需要对比的时候，再次生成覆盖原文即可，在线对比信息会由 Github 自动生成，简单明了。为什么不直接对比 Github adoc 原文？因为他将一个文档每个小节都拆成了单独的 adoc，多达数百个，笔者个人认为这是多余的行为。且不利于他人对树莓派文档进行更新。如果你按原文对比，会发现他提交了几千次更改，但实际上你会发现，他其实一个字也没改。
- 绝不能使用 deepl 进行任何英中翻译 deepl 有一个最大的问题就是 吞字、吞句。他会把他不理解的句式或者单词（比如使用了比喻义）直接无视掉。这个问题至少在 3 年前就存在。而且 deepl 对整句话的翻译往往呈现出相反的意思。 起码对于树莓派官方文档和 FreeBSD 官方手册来说，都是如此。长文本翻译时，有时甚至会直接把他不理解的句子跳过五六七八个不等，无论网页版还是 API 都是如此。而且对句子的理解意思往往是相反的。这对技术文档来说，是致命性的错误，因为 0 和 1 是对立的，在这里不存在辩证法。
- 本项目基于的 Markdown 英文原文存档位于 https://github.com/taophilosophy/rpi-documentation-diff/
- 想要更新本项目，请提出 issue（请先赞助，没 key 了）或直接 PR。