贡献概述
感谢您对贡献 React Native 的兴趣!从评论和分类问题,到审查和发送拉取请求,我们欢迎所有贡献。我们的目标是建立一个充满活力和包容性的合作伙伴、核心贡献者和社区生态系统,超越主要的 React Native GitHub 存储库。
开源指南网站为希望学习如何运行和贡献开源项目的个人、社区和公司提供了一系列资源。
贡献者和开源新手都会发现以下指南特别有用:
行为准则
提醒:所有贡献者都应遵守行为准则。
版本策略
为了充分了解 React Native 的版本控制,我们建议您查看版本策略页面。在该页面中,我们描述了哪些版本的 React Native 受支持、发布频率以及您应根据自身情况使用哪个版本。
贡献方式
如果您渴望立即开始贡献代码,我们有一个适合初学者的好问题列表,其中包含范围相对有限的错误。随着您获得更多经验并表现出对发展 React Native 的承诺,您可能会获得存储库中的问题管理权限。
还有其他无需编写一行代码即可贡献的方式。以下是您可以提供帮助的一些方法:
-
回复和处理未解决的问题。
我们每天都会收到很多问题,其中一些可能缺少必要信息。您可以通过指导人们完成填写问题模板的过程、要求澄清信息或将他们指向与他们的问题描述相匹配的现有问题来提供帮助。我们将在分类 GitHub 问题页面上更详细地介绍此过程。
-
审查文档的拉取请求。
审查文档更新可以像检查拼写和语法一样简单。如果您遇到可以在文档中更好地解释的情况,请单击大多数文档页面顶部的编辑以开始您自己的贡献。
-
帮助人们编写测试计划。
发送到主存储库的一些拉取请求可能缺少适当的测试计划。这些有助于审阅者了解更改是如何测试的,并且可以加快贡献被接受的时间。
这些任务中的每一个都具有高度影响力,维护者将非常感谢您的帮助。
我们的开发过程
我们使用 GitHub 问题和拉取请求来跟踪错误报告和社区贡献。来自 Meta 工程师的所有更改都将通过 Meta 内部源代码控制的桥接同步到GitHub。社区的更改通过 GitHub 拉取请求处理。
一旦在 GitHub 上进行的更改获得批准,它将首先导入到 Facebook 的内部源代码控制并针对 Facebook 的代码库进行测试。一旦在 Facebook 合并,该更改最终将在通过 Facebook 的内部测试后以单个提交的形式同步回 GitHub。
您可以在以下文档中了解有关贡献过程的更多信息:
我们还有一个蓬勃发展的贡献者社区,他们很乐意帮助您入门。您可以通过@ReactNative联系 React Native 团队。
存储库
主存储库包含 React Native 框架本身,我们在这里跟踪错误报告和管理拉取请求。
您可能需要熟悉一些其他存储库:
- React Native 网站,其中包含网站的源代码,包括文档,位于此存储库中。
- 发布相关的讨论正在此讨论存储库中进行。
- 发布的更改日志可以在这里找到。
- 有关 React Native 的讨论发生在讨论和提案存储库中。
- 有关 React Native 新架构的讨论发生在React Native 新架构工作组存储库中。
- 可以在React Native Directory网站上找到 React Native 的高质量插件。
浏览这些存储库应该能让您深入了解 React Native 开源项目是如何管理的。
GitHub 问题
我们专门使用 GitHub 问题来跟踪错误。我们已在分类问题页面中记录了我们的问题处理流程。
安全漏洞
Meta 设有一个漏洞奖励计划,用于安全地披露安全漏洞。在这种情况下,请遵循该页面上概述的流程,不要公开提交问题。
帮助文档
React Native 文档作为 React Native 网站存储库的一部分托管。该网站使用Docusaurus构建。如果您想更改文档中的任何内容,可以单击网站大多数页面右上角的“编辑”按钮开始您的贡献。
如果您添加新功能或引入行为更改,我们将要求您更新文档以反映您的更改。
贡献博客
React Native 博客是从博客的 Markdown 源生成的。
在为 React Native 博客撰写文章之前,请在 React Native 网站存储库中提出问题或在Twitter 上标记 @ReactNative,并获得维护者的批准。在大多数情况下,您可能希望在您自己的博客或写作平台上分享您的文章。不过,如果您的文章非常适合我们的博客,还是值得询问的。
我们建议您查阅react-native-website
存储库的Readme 文件,以了解有关普遍贡献网站的更多信息。
贡献代码
对 React Native 的代码级贡献通常以拉取请求的形式进行。这些是通过 fork 存储库并在本地进行更改来完成的。
分步指南
当您准备好贡献代码时,请查看我们的发送您的第一个拉取请求的分步指南,或阅读如何贡献代码页面以获取更多详细信息。
测试
测试有助于我们防止将回归引入代码库。GitHub 存储库使用 CircleCI 进行持续测试,其结果可通过提交和拉取请求上的检查功能获得。
您可以在如何运行和编写测试页面上了解有关运行和编写测试的更多信息。
社区贡献
对 React Native 的贡献不仅限于 GitHub。您可以通过分享您使用 React Native 的经验来帮助他人,无论是通过博客文章、在会议上发表演讲,还是简单地在 Twitter 上分享您的想法并标记@ReactNative。