技术文档撰写指南

当前阶段
2021 年“文档季”活动已于 2021 年 12 月 14 日结束。请参阅时间轴

本指南面向有兴趣与 2021 年 Google 文档季活动中获批的组织合作的技术文档撰写者。

您是否应参与 2021 年 Google 文档季活动?

通过以下问题,您可以了解您是否有兴趣与参与 2021 年 Google 文档季计划并获得认可的组织合作。

  • 您是否具备技术文档写作技能和经验?“文档季”不打算教授基本的技术写作技能。您是否有上进心并善于管理?
  • 在这六个月(2021 年 4 月至 11 月)的为期六个月的时间内,您是否有时间参与?项目规模不尽相同,但在计划期间每周需要花费 5-30 小时。
  • 您是否有兴趣积累开放源代码方面的工作经验?你愿意花时间了解项目的流程和社区规范吗?
  • 您是否愿意与组织管理员合作,优化其项目提案、制定时间表、评估和汇总指标,并帮助整个组织了解技术文档的价值?

您还应满足计划的资格要求,包括能够创建 Open Collective 账号。请注意,您必须依法接收在您的居住地从事的工作的资金。Season of Google 文档计划管理员无法提供税务建议或回答与您的工作资格有关的问题。

作为参与 Google 文档季的熟练技术文档工程师,您将获得报酬,并获得使用开源的经验,同时您将通过更好的文档帮助您的项目满足关键需求。

以技术文档撰写者的身份参与 2021 年文档季活动

探索阶段

组织申请截止时间为 2021 年 3 月 26 日 18:00(世界协调时间)。我们建议技术文档撰写者尽早开始探索可能的项目。不过,组织可以在 2021 年 5 月 17 日凌晨 1:00(世界协调时间)之前随时选择技术文档撰写人。

  • 查找感兴趣的项目
    • 使用 Google 文档季计划页面上的说明直接与开源组织联系,或查看 Google 文档季的 GitHub 代码库,查找有意参与 Google 文档季的组织。您还可以在 Write the Docs Slack 的 #season-of-docs 频道中找到感兴趣的组织。
    • 选择项目的方法:
      • 选择一个使用您熟悉或感兴趣的语言(例如 JavaScript 或 C)的项目。
      • 选择您感兴趣的技术或领域(例如机器学习、开放科学或机器人)中的项目。
      • 根据社区的友好程度选择项目!访问他们的论坛,查看贡献者的社交媒体账号(如果他们在社交媒体上讨论过自己的项目),并查看他们的新手入门文档(如果有)。
      • 如果您想与项目列表中未列出的项目合作,请与该项目联系,让对方考虑申请加入!
  • 查看项目的提案页面
    • 有了 3-5 个可能的项目后,请查看每个项目的提案页面
    • 您应该通过项目列出的供反馈和讨论渠道提出问题、提供反馈和提出建议。
  • 直接向相应组织提交意向声明。在意向说明中,您将展示自己将如何实现组织的项目提案中规定的目标。
    • 使用 Google 文档季意向声明模板。越短越好!
    • 按照相应组织的“想法”页面上的说明提交意向声明。如果该组织列出了任何特殊要求,请务必在声明中表明您符合这些要求。
    • 提交意向声明即表示您同意遵守该组织的行为准则和“文档季”行为准则。

申请阶段

  • 等待 Google 文档季公布已获批的组织:
    • 如果通过审核的组织想要与您合作或进一步讨论您的意向声明,会直接与您联系。
    • 组织不限于仅与在组织申请截止日期之前提交意向声明的技术文案撰写者合作。他们可能会在接受后征求进一步的利益声明。组织必须在 2021 年 5 月 17 日凌晨 1:00(世界协调时间)之前选择技术文档撰写者。
    • 组织无需针对未能成功提交的意向声明提供反馈。

项目开发阶段

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

最终评估和案例研究阶段

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