跳转到内容

为文档做出贡献

我们欢迎任何大小的贡献和任何技能水平的贡献者。作为一个开源项目,我们相信应该回馈给我们的贡献者。我们很乐意提供指导,帮助你完成 PR,进行技术写作,以及将任何想法变成现实。

如果你想更深入地参与到 Astro 项目中,请查看我们的 治理文档,里面详细描述了不同角色、维护者提名流程、代码审查过程以及行为准则的执行等方面的信息。

贡献的方式

项目仓库

这里有很多方式可以为 Astro 项目做出贡献!每个 Astro 仓库都包含了一个 README 文件,在其末尾会链接到一个 CONTRIBUTING.md 文件。

你可以通过访问 Astro 的 GitHub 主页 来找到以下仓库:

  • Astro 的主要代码库,包括官方集成和脚手架的模板。
  • Astro 文档,一个完整的 Astro 网站!不仅可以贡献书面内容,还可以贡献涉及无障碍性、CSS、UI 和 UX 的 Astro 代码。我们还将文档翻译成多种语言,因此我们需要你的帮助将整个网站翻译成其他语言。
  • Astro 编译器,使用 Go 编写,并以 WASM 形式分发。
  • Astro 的 语言工具,用于 Astro 语言(.astro 文件)的编辑器工具。
  • Starlight,Astro 的官方文档框架。
  • Astro 发展规划,这是制定 Astro 未来发展方向的地方!你可以在这里提出想法、建议和正式的 RFC 提案,甚至参与 Astro 项目的发展。

贡献的类型

除了贡献自己的代码或内容外,你还可以通过参与评审 PR 的过程、在现有的 GitHub Issues 和讨论中提出想法,以及参与我们的「置顶」问题维护任务来做出巨大的贡献,你的参与对整个 Astro 社区来说非常重要!

每个 PR,尤其是翻译 PR,都需要审稿人!审查 PR 并留下评论、建议或批准的「LGTM!」(Looks Good To Me!)是一个在任何项目仓库中上手并了解更多关于 Astro 的好方法。

我们还有一个非常活跃的 Discord 社区!我们非常重视那些欢迎新成员、回答帮助问题,并与其他成员分享他们在 Astro 上构建的内容的贡献!除了传统的 GitHub 贡献之外,Astro 也认可和支持那些与我们的社区互动、在博客文章、视频和会议演讲中分享 Astro 经验,并帮助维护我们社区健康的社区成员。

贡献者指南

我们有几个指南,其中包含有关如何开始为 Astro 文档网站做出贡献的信息!

这也有些适用于 Astro 社区内角色的指南。

我们的贡献者

这些文档由所有这些有帮助的人提供。在 GitHub 上加入我们!