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