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