项目创意

当前阶段
结果已公布。请参阅时间轴

本页面适用于处于组织申请流程探索阶段的开源组织。这些项目想法仅供参考,旨在展示组织如何在其项目想法页面上描述可能的文档项目;组织可以提议不在此列表中的项目。

项目想法:创建贡献者新手入门指南

问题

  • 新贡献者找不到为我们的项目做出有意义贡献所需的设置信息。某些流程(例如对我们的测试做出贡献)根本没有记录。

我们如何衡量成效?

  • 新贡献者数量增加
  • 增加非代码贡献者的数量(通过简化文档或测试的贡献方式)
  • 减少新贡献者提出的问题数量
  • 标记为“适合新手尝试的问题”且已关闭的问题数量增加

技术文档工程师需要具备哪些技能才能参与此项目?

  • 必备条件:熟悉 GitHub(或愿意学习 GitHub 教程)
  • 有用:熟悉我们的测试运行程序,以便运行测试并更新相关文档

志愿者

鼓励社区成员注册以帮助完成特定任务,例如

  • @JaneQDev,可以帮助解答有关我们测试的问题
  • @ChenPCoder,很高兴能审核文档拉取请求
  • @ErichJEngineer,可以与技术文档撰写人员一起介绍当前的贡献流程

联系信息

  • 如果有技术文案撰写者有意参与此项目,请发送电子邮件至 email@project。请附上指向您的技术写作作品或作品集/简历/履历的链接。

项目创意:编写使用我们的库的教程 ...

问题

  • 我们的项目收到了许多用户在尝试将我们的库与 $TechnologyX 搭配使用时遇到的问题。我们没有关于如何与 $TechnologyX 集成的明确指南,而且可能会很棘手!

我们如何衡量成效?

  • 标记为“$TechnologyX”的问题数量减少
  • 新贡献者提交的拉取请求数量增加,帮助我们修复 bug 或添加 $TechnologyX 相关文档
  • 更多指向 $TechnologyX 项目的链接

技术文档工程师需要具备哪些技能才能参与此项目?

  • 建议条件:对 $TechnologyX 有一定的了解

志愿者

鼓励社区成员注册以帮助完成特定任务,例如

  • @JaneQDev,可以帮助解答有关 $TechnologyX 的问题
  • @ChenPCoder,很高兴能审核文档拉取请求

联系信息

  • 如果有技术文案撰写者有意参与此项目,请发送电子邮件至 email@project。请附上指向您的技术写作作品或作品集/简历/履历的链接。

项目想法:重新整理文档

问题

  • 我们的文档资料杂乱无章,许多用户放弃了尝试在文档中查找答案,而只是在我们的论坛中提出问题或提问。我们的网页不会出现在搜索结果中,即使使用相关关键字也是如此。

我们如何衡量成效?

  • 优化我们文档的搜索引擎优化 (SEO)
  • 减少针对文档中涵盖的主题提出的问题数量
  • 文档贡献数量增加

技术文档工程师需要具备哪些技能才能参与此项目?

  • 加分项:有重新整理大型成熟文档集的经验,了解搜索引擎优化

志愿者

鼓励社区成员注册以帮助执行特定任务,例如

  • @ChenPCoder,很高兴能审核文档拉取请求

联系信息

  • 如果有技术文案撰写者有意参与此项目,请发送电子邮件至 email@project。请附上指向您的技术写作作品或作品集/简历/履历的链接。

项目创意:运行文档修复

问题

  • 我们的文档存在许多小 bug 和旧问题。我们的社区会非常乐意提供帮助,清理这些问题,但我们需要有人来组织和运行实际的修复。

我们如何衡量成效?

  • 已关闭的文档相关问题的数量
  • 文档贡献者和新贡献者数量增加

技术文档工程师需要具备哪些技能才能完成这个项目?

  • 有助于胜任:有文档修复程序运行经验
  • 出色的组织能力

志愿者

鼓励社区成员注册以帮助完成特定任务,例如

  • @ChenPCoder,可以帮助整理 Fixit 的视频和聊天内容,并帮助寻找其他时区的志愿者

联系信息

  • 如果有技术文案撰写者有意参与此项目,请发送电子邮件至 email@project/在我们的论坛中创建问题/提问。请附上指向您的技术写作作品或作品集/简历/履历的链接。

项目想法:进行文档审核

问题

  • 我们不清楚文档的状态!我们很难确定优先改进哪些文档,因为我们没有路线图,也不知道哪些问题最紧迫。我们还有许多过时内容需要删除或归档。

我们如何衡量成效?

  • 创建一份文档路线图并获得社区的一般批准
  • 减少过时或不正确的文档页面数量

技术文档工程师需要具备哪些技能才能完成这个项目?

  • 建议条件:拥有进行文档审核的经验

志愿者

鼓励社区成员注册以帮助执行特定任务,例如

  • @JaneQCoder,可以协调在社区会议中展示文档路线图

联系信息

  • 如果有技术文案撰写者有意参与此项目,请发送电子邮件至 email@project/在我们的论坛中创建问题/提问。请附上指向您的技术写作作品或作品集/简历/履历的链接。
  • 宣传和媒体页面包含徽标和其他内容,可供您在宣传 Google 文档季活动时使用。
  • 2017 年 PyCon Australia 的这个视频提供了有关如何整理文档的提示,以便他人发现文档有用: Daniele Procida 撰写的关于文档的方方面面