波卡的Wiki由Web3基金会启动和维护。它是一个开源项目,旨在成为Polkadot和Kusama生态系统中最大的知识资源。目前有很大一部分资料都是围绕着Polkadot和Kusama,但并也包含覆盖社群项目的信息材料。
尽管如此,还是鼓励来自社区的Pull Request*、讨论和贡献。可以向表现出良好贡献记录的活跃社区成员授予对存储库的写入权限。
编者注:Pull Request*:是一种GitHub等在线git服务的功能,让你可以向一个仓库(repository)提出修改建议,即使你没有访问该仓库的权限。你可以使用pull request来进行开源协作,或者在团队中进行代码审查。
Web3基金会对包含的内容拥有管理地位和最终决定权。具体来说,基金会的技术教育团队是起到主导地位的。
如何贡献
您可以在存储库上为Wiki做贡献。每个页面都是一个MarkDown文件,这是一种易于学习的纯文本语法扩展,可以轻松创建链接、渲染图像和美观的格式。
每个页面的内容底部都有一个“编辑此页面(Edit this page)”链接。通过单击它,您将被带到GitHub登录页面,您可以在其中登录或创建一个帐户。
登录后,您将被带到GitHub内置的文本编辑器,您可以在其中直接进行编辑。完成更改后,您可以添加有关更改内容的任何特定详细信息,并提交到新分支以向存储库创建新的合并请求。其中一位维护者将审查您的更改,然后合并它们或请求更改。
存储库,详情请参见:
https://github.com/w3f/polkadot-wiki
请记住,在您点击“Propose Changes”之后,您还必须在下一页点击“Create Pull Request”。
贡献指南和规则
贡献者有一些基本的基本规则:
1.不得以任何--force方式推送或修改Git历史记录。
2.与issues功能相比,更推荐使用Pull request,尤其是对于拼写错误等小的更改。issues应该用于通用或基础广泛的更改或缺失的内容。鼓励大家提出建议和要求。
3.只使用non-master分支。
4.重大修改,即使是贡献者所做的,也应该受到Pull request的约束,以征求其他贡献者的反馈。
5.鼓励对任何其他重要贡献征求反馈的Pull request,但由贡献者自行决定。
6.贡献者应尝试坚持流行的MarkDown风格、语言和布局。
7.应始终使用正确的语法。有拼写错误的Pull request在修复之前不会被合并。
8.应注意尽可能保持客观和信息丰富。不应有主观评论,也不应存在外部偏见。
9.我们使用一个名为Prettier的插件来标准化跨文档的样式。可以用npx pretty-quick --staged本地副本上运行它,但为简单起见,我们还有一个机器人可以在您的PR中运行。
继承
资料来源,详情请参见:
https://github.com/Level/community/blob/master/CONTRIBUTING.md
帮助翻译
Wiki的默认语言是英语,但我们希望将Wiki翻译成尽可能多的语言。您可以做出贡献的另一种方式是帮助翻译。
Polkadot Wiki主页底部有一个功能,可以将您重定向到crowdin,这是可以进行翻译贡献的地方。在那里,您将看到以多种不同语言翻译与Wiki相关的文档的进度。
crowdin,详情请参见:
https://crowdin.com/project/polkadot-wiki
以下是有关如何在crowdin界面应用以进行翻译的步骤。也可以查看官方的crowdin知识库。
官方的crowdin知识库,详情请参见:
https://support.crowdin.com/online-editor/
下面显示了阿拉伯语的示例。您可以在提供的区域中为每个部分输入所需的翻译,同时也可以使用crowdin内置翻译器生成的建议。
记得将您的内容存档。