如何为开源项目做出贡献

本指南假设基本的命令行和GIT熟悉度提供了有关为开源项目做出贡献的建议。如果您准备好逐步说明，请前进到“操作方法”部分。

为开源做出贡献不仅仅是编码。本指南重点是在GitHub上创建和提交拉动请求（PR）。

入门

您已经找到了一个很棒的GitHub项目，并想贡献！也许您已经发现了一个错误，增强机会或提高代码可读性的方法。这是继续进行的方法：

检查贡献指南

许多项目都有CONTRIBUTING.md文件或文档中的类似贡献指南。本文档阐明了：

• 样式指南
• 公关提交先决条件
• 文档更新过程
• 贡献清单
• 项目体系结构和设置

这些指南范围从简洁的笔记到广泛的文件。审查本指南至关重要；它可以节省您和维护者的时间。

查看现有问题和公关

在创建新问题或公关之前，请搜索项目的问题（开放和关闭），以避免重复努力。

提交问题

问题对PR至关重要。他们提供了一个平台来描述问题，添加上下文并促进讨论。提交问题时：

• 对于错误：指定环境（开发，生产等）。
• 对于功能请求：清楚地说明问题，可能使用用户故事。
• 对于一般问题：明确说明问题的本质。
• 如果在开始工作之前提供PR：请求许可。

保持尊重的语气；请记住，维护者自愿工作。

发展前的考虑

在开始PR之前：

• 征求许可：通过问题查询您的公关的可行性。这样可以节省时间并防止冗余工作。
• 使用标签：将“正在进行的”标签添加到您的问题中以发出您的作品。
• 小块工作：提交多个小型PR，专注于个人主题。这简化了审查并增加了合并的可能性。

提交您的公关

这些步骤概述了公关提交过程：

1. 叉子存储库：在您的github帐户上创建项目的叉子。
2. 本地克隆：克隆您的分叉存储库： git clone https://github.com/YOUR-USERNAME/YOUR-FORKED-REPO.git
3. 添加上游：将遥控器添加到原始存储库： git remote add upstream https://github.com/ORIGINAL-DEV-USERNAME/REPO-YOU-FORKED-FROM.git和fetch Change： git fetch upstream
4. 创建一个分支：创建一个具有描述性名称的新分支： git checkout -b MEANINGFUL-BRANCH-NAME
5. 进行更改：实施您的更改并使用清晰的消息提交： git add -A ， git commit -m "CLEAR AND CONCISE COMMIT MESSAGE"
6. 推到叉子： git push origin MEANINGFUL-BRANCH-NAME
7. 创建PR： GITHUB将指导您创建PR。链接相关问题。在您的公关描述中提供上下文。
8. 保持叉子的更新：从原始存储库中拉更改： git pull upstream master

记住要尊重维护者的时间。开源很有意义；贡献有利于社区和您的学习。感谢克里斯蒂娜·索拉纳（Christina Solana）的要旨的灵感。

以上是如何为开源项目做出贡献的详细内容。更多信息请关注PHP中文网其他相关文章！