【飞桨体验评测任务第二期】

[TCChenlong]

一、背景介绍

2022年飞桨将重点开展开发者生态贡献机制，建立开发者与飞桨的多样化联动，共同打造优秀的开源生态。在今年1月，我们开展了第一次评估，重点放在了API文档与目录大纲评测以及安装文档与报错评测，共收集到反馈 210+条，为相关产品的优化提供了重要的信息输入。为了进一步提升飞桨框架的使用体验，我们诚挚的邀请你参与到第二期体验评估中，这次主要是飞桨训练框架文档评估与Paddle Lite 的文档评估，并且和我们一起共建飞桨框架，后续会陆续安排其他产品模块的体验评测，希望大家持续关注。

二、参与流程

三、具体任务：

1、飞桨框架使用指南&应用实践评测任务（文档评估）

• 任务名称：飞桨框架使用指南评测 负责人微信昵称：TC.Long
• 任务描述：我们精选了12篇使用指南&应用实践文档，并将其分为5组，每组包含2~3篇文档。完成该评测，请先阅读对应文档，然后根据问卷（即该文档的各项评估指标），对该文档进行评估（注意，每个文档都需要单独填写一次问卷，请一定填写正确文档名称与你的微信昵称），此外，对于该文档的所有建议，都可以填写到主观评价中。
• 任务分配：为了降低bias，每组都会请3位同学来做交叉评测，即你可以在表格的 epoch 1、epoch 2、epoch 3中任意认领1项任务。
• 任务提交：你需要完成以下操作和内容，
  （1）完成文档的评估问卷。【问卷链接见群公告】
  （2）共享 Excel 中更新文档评估状态。【表格见群公告】
  （3）评测群中 @TC.Long 完成评估。

2、Paddle Lite文档 - 内容评测任务

• 任务名称：Paddle Lite文档 - 内容评测 负责人群昵称@憨憨

• 任务描述：针对Paddle Lite文档中，关于核心功能使用的几个主要模块，你可根据自己的开发经验及兴趣点，选择一组文档进行针对文档内容的测评（一般具有内容关联性），并为每篇文档需独立填写一次问卷；请选择《文档内容评测问卷》进行填写。
  （1）评估范围：单篇文档全部内容（包含链接所指向的外部资源或页面）；对于【N选X】类型分组，在多篇文档中至少选取与自己开发环境和兴趣相吻合的X篇进行评估即可；
  （2）评估方式：尽量在阅读文档所有内容并充分理解后，按照问卷评估维度对文档内容打分、并反馈与相关建议和问题；
  （3）内容连贯性：如果你发现所阅读内容难以理解，或是文档中明确注明需要依赖前序文档，请首先阅读前序文档内容（大部分文档的任务分组为相对独立的内容模块）；

• 任务分配：为了降低bias，每组都会请3位同学来做交叉评测，即你可以在表格的 epoch 1、epoch 2 中任意认领1项任务。

• 任务提交：你需要完成以下操作和内容，
  （1）完成Paddle Lite《文档内容评测问卷》。【问卷链接见群公告】
  （2）在共享 Excel 中更新文档评估状态、并填写建议。【表格见群公告】
  （3）评测群中 @憨憨 完成评估

3、Paddle Lite文档 - 操作实践任务

• 任务名称：Paddle Lite文档 - 操作实践 负责人群昵称@憨憨

• 任务描述：针对Paddle Lite文档中涉及具体操作实践的文档，你需要根据自己的开发经验&软硬件平台情况，选择一组可在本地环境运行的操作实践任务，并为每篇文档需独立填写一次问卷；请选择《操作实践评测问卷》进行填写。
  （1）评估范围：文档评估范围为单篇文档内的内容描述，实践体验以及链接所指向的辅助资源中的内容；对于【N选X】类型分组，在多篇文档中至少选取与自己开发环境和兴趣相吻合的X篇进行评估即可；
  （2）评估方式：请先熟悉问卷中的评估标准，然后按照文档指引逐步完成文档中的操作步骤，并将进度记录在问卷中的阶段打卡点中；完整完成全部流程、或因某些无法解决的原因导致无法进行后，请将所记录下的与问卷中问题相关的信息，整理并填写到问卷中，完成主观评价指标的选择；
  （3）环境限制：对于实践操作类文档，一般要求阅读文档的开发者拥有与文档内容相匹配的硬件 (带有相关CPU/GPU/NPU的设备) 和软件 (操作系统) 环境；请在选择前确认有与文档相符的本地环境，如果因客观原因无法满足，可只进行主观评价不用进行操作，并在问卷中注明；
  （4）任务选择：建议你在选择任务时，根据自己特定的软硬件环境，匹配关联的文档进行评测（eg. 选取【X86源码编译】完成环境准备，同时选取【X86应用示例】完成应用开发）；

• 任务分配：为了降低bias，每组都会请3位同学来做交叉评测，即你可以在表格的 epoch 1、epoch 2 中任意认领1项任务。

• 任务提交：你需要完成以下操作和内容，
  （1）完成Paddle Lite《操作实践评测问卷》。【问卷链接见群公告】
  （2）在共享 Excel 中更新文档评估状态、并填写建议。【表格见群公告】
  （3）评测群中 @憨憨 完成评估
  【在评测过程中，如遇到任何报错或问题，可以在微信群中随时提出，我们会有专门技术同学支持。】

4、第一次评估API文档问题修复

• 任务名称：第一次评估API文档问题修复 负责人微信昵称：TC.Long
• 任务描述：在第一期的评估任务中，我们的重点方向是飞桨API文档及目录、安装模块。其中有很多已经转为需求，进行研发中；此外，我们也精心挑选了一部分反馈，希望你可以加入到飞桨文档的建设中来。
• 如何参与：请参考 【飞桨体验评测任务第一期】API文档问题列表 。

当然，你可以提交PR，修改你认为有问题的地方，将PR回复到评测群中并 @TC.Long & @tina侨 以完成修复，为了感谢你的贡献，我们会奖励额外的积分！

四、答疑

在评估过程中，有任何问题，都可以在群中或此ISSUE下进行提问，我们会尽快解答你的问题~

五、最后

再一次感谢你参与飞桨框架体验评估任务，我们会认真参考你的评分与建议，打造最好用的深度学习框架！