Skip to content

Latest commit

 

History

History
143 lines (79 loc) · 8.43 KB

CONTRIBUTING.md

File metadata and controls

143 lines (79 loc) · 8.43 KB
此指南可阅读的语言版本 English 中文 русский عربي Español Português

贡献指南

您好👋!

freeCodeCamp.org的存在是因为像你这样的数千名志愿者。我们很感谢与欢迎您的贡献。

我们严格执行[“行为准则”](https://www.freecodecamp.org/code-of-conduct)。请您花一点时间阅读它。它只有196个字。

祝您贡献愉快🎉!

您可以通过以下这些不错的方式进行贡献

您可以选择为您感兴趣的任何领域做出贡献:

  1. 贡献予开源代码库。帮助编辑指南文章编码挑战或修复学习平台上的错误。

  2. 在我们的公共论坛上帮助营员。回答他们的编程问题为他们的编码程目给予反馈

  3. 帮助我们为YouTube频道视频添加字幕。

##贡献予开源代码库

我们有数以千计的编码挑战指南文章集中在这个庞大的开源代码库中。

您可以帮助我们:

研究,编写和更新我们的指南文章

什么是指南文章?

指南文章可帮助您快速了解技术概念。它是用简短,简单的英语解释,您可以在阅读更深入的资源之前先阅读这些解释。

您可以在这里找到关于HTML锚点元素的示例文章

我能写一篇关于什么的文章?

我们欢迎您撰写这些文章的帮助。作为作者你不必是一个主题的专家 - 整个指南是开源的,所以即使你犯了错误,另一个贡献者最终会纠正它。

您可以在我们的[指南网站](https://www.freecodecamp.org/guide)上找到一个“存根文章”,写下您的文章,然后建立pull request以替换存根文章。 [pull request](https://help.github.com/articles/about-pull-requests/)是您建议更改的方式。它让其他人了解您的更改,审核并采用它们。

如果您找不到关于您想要撰写的主题的存根,则可以开一个PR,创建有关存根并包含您的草稿文章。

如果您想帮助改进指南文章,请参阅[如何编辑指南文章](/docs/how-to-work-on-guide-articles.md)。

创建,更新编码挑战和修复其中的错误

我们所有的编码挑战都由社区策划,以从您这样的志愿者那里获取专业知识。

您可以帮助扩展它们并使其措辞更加清晰。您可以更新用户故事以更好地解释概念,甚至删除多余的概念。您还可以改进挑战测试,使其更准确地测试人们的代码。

如果您对改进这些编码挑战感兴趣,请参阅如何处理编码挑战

翻译指南文章和编码挑战

您可以帮助我们将指南文章和编码挑战翻译成您所说的语言。目前我们已翻译版本:

我们非常欢迎您的贡献以帮助提高翻译质量。数百万人已经在使用freeCodeCamp.org的英语版本,我们也希望还有数百万人使用这些翻译版本。

帮助我们修复freeCodeCamp.org学习平台中的错误

我们的学习平台运行在现代的JavaScript技术栈上。它有各种组件,工具和库,包括但不限于Node.js,MongoDB,LoopBack,OAuth 2.0,React,Gatsby,Webpack等。

简单的说,

  • 我们有一个基于Node.js的API服务器。
  • 一组基于React的客户端应用程序。
  • 用于评估前端项目的脚本。

为此做出贡献需要对API和ES6语法有所了解,更需要足够的好奇心。

基本上我们期望您对于以上的一些技术,工具和库有某些基本的熟悉程度。但是,您不需要是这些领域的专家。

如果您对于以上相关问有任何疑问,请在相关的主题上向我们提问,我们将很乐意的为您澄清。您可以联系我们的平台开发团队中的Mrugesh Mohapatra @isedadead 或Stuart Taylor @bouncey 为您提供帮助。

如果您想帮助我们改进代码库,请参阅如何在本地启动freeCodeCamp

常见的疑问

如何报告不在记录里的问题?

如果您认为自己发现了错误,请先阅读“请帮忙!我发现了一个错误”文章并按照其说明进行操作

如果您确信这是一个新错误,请继续创建一个新的GitHub问题。请务必尽可能多地包含信息,以便我们能重现错误。我们有一个预定义的问题模板来帮助您完成此报告。

请注意,任何寻求编码帮助挑战的问题都将被关闭。问题跟踪器严格用于与代码库相关的问题和讨论。您应该在论坛上寻求帮助, 然后在有疑问时进行报告。

如何报告安全问题?

请不要因安全问题而创建GitHub问题。相反,请发送电子邮件至[email protected],我们会立即调查。

我被困在这些文档中没有解释的问题上。怎么能得到帮助?

您可以透过以下的管道:

我们很高兴能帮助您为您想要处理的任何课题做出贡献。确保在发布新查询之前搜索您的查询。请务必要有礼貌和耐心。我们的社区志愿者和主持人随时为您提供指导。

我是GitHub和开源的新手:

阅读我们的如何参与开源指南

这些标记在问题上的不同的标签是什么意思?

我们的社区版主分类 根据优先级,严重程度和其他因素发出请求。您可以在这里找到一个完整的含义词汇表

您应该通过“求助”“欢迎新手”快速查找您可以贡献的项目。这些都是可以自行进行,并不需要批准。

如果这些项目缺乏明确的需求,请在评论中提问。

我发现了一个错误的拼写,我应该在提出PR之前报告问题吗?

对于拼写错误和其他措辞更改,您可以直接打开请求,而无需先创建问题。问题更多的是讨论与代码相关,或者课程结构方面的重大问题。