以技术文档工程师的身份撰写评估结果

当前阶段
2019 年 Google 文档季计划已于 2020 年 3 月 6 日结束。请参阅时间轴

在 Google 文档季的项目定稿阶段,参与的技术文档撰写者会评估自己与导师和项目的体验,以及他们对 Google 文档季的整体参与情况。

提交您的评估

当项目敲定阶段开始后,您可以通过填写技术文档撰写指南的项目敲定部分中提供的表单来提交评估。

要纳入评估的信息

本部分介绍了作为参与的技术文档工程师,您可以在评估中提供的信息类型。评估表单将包括自由文本字段和选择题。

您在文档使用季期间的成就:

  • 想一想您最初的项目计划,您距离实现最初概述的所有目标还有多远?
  • 在文档使用季期间,您每周平均花几个小时进行项目?
  • 关于您的成就的评论。请考虑以下问题:

    • 您是否解决了意外问题?
    • 您是否添加了原始方案未包含的所需文档?
    • 您是否为代码和文档提供了贡献?
    • 您是否改进了开源组织的贡献流程?
    • 是否有可以量化改进的指标(例如网页浏览量或网页满意度的提升)?

作为《文档季》的技术文档撰写者,您的以下体验:

  • 在《文档季》中,您最喜欢的环节是什么?
  • 您认为参加文档季最具挑战性的环节是什么?
  • 您会再次申请使用文档季吗?
  • 你如何评价自己使用文档季的总体体验?
  • 《文档季》有没有帮助你加深了对代码和/或开源的了解?
  • 您未来是否会考虑成为《文档季》的导师?
  • 对于未来有兴趣参加《文档季》的技术文档撰写人,您有什么建议帮助他们做好准备?
  • 评论您在《文档季》中担任技术文档工程师的体验。例如,请考虑以下问题:

    • 您是否在以写入者而不是开发者的身份加入开源项目时遇到了问题?
    • 如果是,您和导师是如何处理这些问题的?

您在文档季中与开源导师交流的体验:

  • 您是否会向其他技术文档工程师推荐导师?
  • 评价导师互动的质量。
  • 您的导师对问题和审核请求的响应速度如何?
  • 您是否遇到过与导师或组织有关的问题?
  • 为了在未来更好地帮助技术文档工程师,您的导师或此组织可以采取哪些不同措施?
  • 您是否有任何反馈要提供给开源组织和导师?
  • 有关您与导师之间关系的评论。例如,请考虑以下问题:

    • 在计划期间,指导关系是否有变化?
    • 如果不正常,表现在哪些方面?

您在开源方面的计划和经验:

  • 您打算继续为这个开源组织做贡献吗?
  • 您是否打算基于对文档季的使用体验为更多开源项目做贡献?
  • 在《文档季》推出之前,您是否为该开源组织贡献了文档或代码?
  • 您是否为任何其他开源项目贡献过文档或代码?

笼统介绍:

  • 您还有其他想要告诉 Google 计划管理员的吗?或者,您对如何改进该计划有什么建议吗?
  • 作为文档季的参与者,您是否遇到过任何惊喜?