照着跑失败了,该改哪儿
新人照 README 跑失败了,第一反应应该是【0】。
照着跑,能走到第几步
四步说明,仓库里缺一个文件。运行下面这段程序,看成功跑过几步、卡在第几步: def dry_run(steps, files): for i, (cmd, need) in enumerate(steps, 1):
补上文件之后能走完吗
把缺的文件补进仓库,再照着跑一遍。运行下面这段程序: def dry_run(steps, files): for i, (cmd, need) in enumerate(steps, 1): if need and
写一个"能走多远"
补全 reach(steps, files):返回成功跑过的步数(全部跑通就返回总步数)。
修复前后能走多远
输出两样:修复前跑过几步 / 修复后跑过几步。
⚠️ 给这份文档打个分
把四项检查合起来打一个分:缺的小节 / 没说明的函数 / 跑不通的示例 / 能走完全部步骤吗。 四样拼起来输出(最后一项是 True/False)。
写文档该从哪一节开始
从零写一份项目文档,最该先写的是【0】。
文档写完了,怎么算验收通过
判断一份项目文档合格的标准是【0】。
五项一起对得上吗
把这条路线算过的东西一次验完。运行下面这段程序: def missing(need, have): return [s for s in need if s not in have] def no_doc(funcs):
第一步:先给文档做个体检
写出四条检查,输出四样:缺节数 / 没说明函数数 / 坏示例数 / 三项合计。