title: "贡献指南" post_status: publish comment_status: open taxonomy: category: - wp-cli-handbook post_tag: - Contributions - Repos - Data

贡献指南

欢迎并感谢您的参与！

我们非常感谢您主动为 WP-CLI 项目贡献力量。正是因为您和您周围的社区成员，WP-CLI 才能成为如此优秀的项目。

贡献不仅限于代码编写。 我们鼓励您以最适合自己能力的方式参与贡献：可以撰写教程、在当地交流会上进行演示、帮助其他用户解决支持问题，或是修订我们的文档。

请花些时间仔细阅读以下指南。遵循这些指南能体现您对项目其他贡献者时间的尊重。相应地，他们也会跨越时区和地域，在与您协作时尽力回报这份尊重。

若对贡献流程有任何疑问，请加入 WordPress.org Slack 的 #cli 频道进行交流。

WP-CLI 团队和 WordPress 社区高度重视安全漏洞。我们感谢您负责任地披露发现的问题，并将尽力认可您的贡献。

如需报告安全问题，请访问 WordPress HackerOne 项目。

认为自己发现了错误？我们非常希望您能协助我们修复它。

在创建新议题前，请先搜索现有议题，查看是否已有解决方案，或该问题是否已在 WP-CLI 的更新版本中被修复。同时，请查阅我们关于常见问题及其修复的文档。

完成搜索并确认您的错误尚无公开议题或未被修复后，请遵循我们的错误报告提交指南，以确保问题能得到及时处理。

想要贡献新功能吗？WP-CLI 是一个成熟的项目，已经包含了大量实用功能。请先开启功能建议议题来提议新命令，或在相应仓库中开启议题来提议对现有命令的改进。在提交拉取请求前开启议题，有助于我们在您投入过多编码时间前提供架构和实现指导。

初次接触 WP-CLI 代码库？查看标记为'good-first-issue'的议题作为切入点。这些议题专门为新贡献者预留。

当您决定投入时间完成拉取请求时，请遵循我们的拉取请求创建指南以确保良好体验。关于本地修改 WP-CLI 的详细信息，请参阅"环境设置"。请注意拉取请求需要包含覆盖变更范围的测试。阅读我们的代码审查指南能帮助您更好地理解拉取请求的评估标准。

文档编写是你的强项吗？请查看当前开放的文档问题，看看能否解决其中一些问题。

WP-CLI 目前包含几种不同类型的文档：

单个 WP-CLI 命令的文档（位于 developer.wordpress.org/commands 下的所有内容）包含在每个命令的 PHPDoc 中。这意味着要编辑命令的文档，你需要编辑实际提供该命令功能的文件。Web 文档是在发布时从这些文件生成的，因此你可能需要等到下一次发布才能看到你的更改。
单个文档页面（位于 make.wordpress.org/cli/handbook 下的所有内容）可以通过贡献到 GitHub 上的手册仓库来编辑。不过，你不一定需要浏览 GitHub 仓库；任何属于此仓库的页面都会在页面右上角有一个“编辑”链接，点击它将带你到 GitHub 上的相应文件。

欢迎随时创建问题提出疑问，我们将尽力为您解答。

此外，如果您拥有 WordPress.org 账户，也可以考虑加入 WordPress.org Slack 组织中的 #cli 频道。