技术文档撰写指南

当前阶段：
文档制作。请参阅时间表。

本指南适用于有兴趣与 Google 文档季计划中已接受的组织合作的技术文档撰写人。

您应该加入 Google 文档季计划吗？

这些问题有助于您了解您是否有兴趣与 Google 文档季计划中收录的组织合作。

  • 您是否具备技术写作技能和经验？“Google 文档季”并非旨在教授基本的技术写作技能。您是否能够积极主动地开展工作，工作有条不紊？
  • 在为期六个月的计划中，您是否有时间参与进来？ 项目规模不尽相同，但在计划期间每周需要 5-30 小时。
  • 您是否有兴趣获取开源领域的工作经验？您是否愿意花时间学习项目的流程和社区规范？
  • 您是否愿意与组织管理员合作来优化他们的项目提案、制定时间表、评估和编制指标，并帮助整个组织了解技术写作的价值？

您还应符合该计划的资格要求，包括能够创建 Open Collective 帐号。您必须能够依法获得在居住地开展的工作所需的资金。Google 文档季管理员无法提供税务建议或回答与您的工作资格有关的问题。

作为参与 Google 文档季的资深技术文档撰写者，您将获得参与开源工作的经验，同时通过更好的文档帮助您的项目解决关键需求。

以技术文档作者身份参与 Google 文档季计划

探索阶段

组织申请截止时间为世界协调时间 (UTC) 2024 年 4 月 2 日 18:00。我们建议技术文档工程师尽早探索可能的项目。但是，组织可以选择在 2024 年 5 月 22 日 18:00（世界协调时间）之前随时与技术文档工程师合作。

  • 查找您感兴趣的项目
    • 请按照开源组织“Google 文档季”计划页面上的说明直接联系，或查看 Google 文档季 GitHub 代码库，以查找有兴趣参与“Google 文档季”的组织。您还可以在编写文档 Slack 的 #season-of-docs 频道中找到感兴趣的组织。
    • 下面是选择项目的一些方法：
      • 选择使用您熟悉或感兴趣的语言（例如 JavaScript 或 C）的项目。
      • 选择您感兴趣的技术或领域（例如机器学习、开放科学或机器人）中的项目。
      • 请根据社区的友好程度选择项目！访问他们的论坛，查看贡献者的社交媒体帐号（如果他们在那里讨论自己的项目），并查看他们的入职文档（如果有）。
      • 如果你想要参与的项目不在项目列表中，请与该项目联系，并让他们考虑申请！
  • 查看项目的提案页面
    • 当有 3-5 个可能的项目后，请查看每个项目的提案页面
    • 您应该使用项目列出的用于反馈和讨论的渠道提出问题、提供反馈和提出建议
  • 直接向组织提交意向声明。在意向说明书中，您将展示如何实现组织的项目提案中制定的目标。
    • 使用 Google 文档季的意向调查表模板。越短越好！
    • 请按照组织“提示”页面上的说明提交您的意向说明。如果组织列出了任何特殊要求，请确保在声明中表明您满足这些要求。
    • 提交意向声明即表示您同意遵守本组织的行为准则和 Google 文档季行为准则。

应用阶段

  • 等待 Google 文档季公布已接受的组织：
    • 如果获批的组织想与您合作或进一步讨论您的意向声明，将直接与您联系。
    • 组织不仅限于与在组织申请截止日期之前提交了意向声明的技术文档工程师合作。在接受该协议后，他们可能会征求进一步的权益声明。组织必须在世界协调时间 2024 年 5 月 22 日 18:00 之前选择技术文档撰写人。
    • 对于失败的意向声明，组织无需提供反馈。

项目开发阶段

  • 与组织合作制定时间表，包括交付成果和截止时间。

最终评估和案例研究阶段

  • 与组织合作，提供最终评估和案例研究所需的信息。