项目创意

当前阶段
案例研究已发布。请参阅时间轴

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

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

问题

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

我们如何衡量成效?

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

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

  • 必备条件:熟悉 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/open 一个 issue 或在我们的论坛中提问。添加指向您的技术写作作品或作品集/简历/履历的链接。

项目想法:进行文档审核

问题

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

我们如何衡量成效?

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

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

  • 加分项:有文档审核经验

志愿者

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

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

联系信息

  • 如果有技术文案撰写者有兴趣参与此项目,请发送电子邮件至 email@project/open 一个 issue 或在我们的论坛中提问。添加指向您的技术写作作品或作品集/简历/履历的链接。
  • 宣传和媒体页面包含徽标和其他内容,可供您在宣传 Google 文档季活动时使用。
  • 以下视频来自 2017 年 PyCon Australia 大会,其中 Daniele Procida 提供了一些提示,可帮助您整理文档,使其对用户有用:关于文档的那些不为人知的秘密