1
NBXX2018 2023-04-25 15:01:19 +08:00
您好,看了您的教程,觉得还是有一些改进空间,我从大到小的范围来说:
1 、知识引入和章节标题的命名: 我看到 OP 是用另一种面向完全零基础学习者的口吻,然后拆散了传统按部就班的介绍,用各种故事做引子来推进学习。 那么其实可以用更完整的故事来讲述文档,比如我们从一开始就是在构建一个自己的机器人小管家:第一章“给它安上嘴巴!”,可以继续沿用 OP 用 print 引入函数概念的思路。之后还可以用类似于“让机器人拿到新装备”的故事,引 import 和包管理等云云,把整个机器人小管家的形象,通过我们 python 学习丰满起来,营造一种“阶段性成就感”。 此外现在章节命名有些混乱,01 、02 是口语化的,而 03 、04 、05 又变成教材语气了,且内容并不包含标题的所有方面内容,不利于后续查阅。 2 、概念出现顺序冲突: 003.缩进和循环中,for 循环小节有这么一句“其中 i 是循环遍历 range 返回的 0 、1 、2 ,然后执行代码块里的语句其中 i 是循环遍历 range 返回的 0 、1 、2 ,然后执行代码块里的语句”,那么 i 到底是什么?是一个临时变量,用于存放每次取出来的值。 但是 OP 没有一开始讲变量这个概念而是放到了 004.条件语句里,而 range 的讲解中无意提到了多个函数传参,这个问题又是在下一章才出现的,新手看到这个案例只能硬啃下去。在后续教程编写的时候,希望可以少一点这些“超前”的知识,虽然对于会的人很基础。 3 、分段标题和语法糖: 004 章之后的分段标题趋于混乱,很多非重点内容也单独出了个大标题,如果后续左侧目录做展开显示的话,读者看到分段标题叫“让我们回到老婆让老公买东西的问题”,能猜到这段写的是什么内容吗?标题分段尽可能简洁规范。 同样是 004 章,介绍到了 f-string 。这个是 3.6 版本之后才引入的一个写法,虽然直观简单但是我觉得不应该直接引入,同时也没有教其他的字符串格式化方法(比如%、format ),不利于后续知识结构化掌握。这里语法糖,后续肯定还会有很多。建议用一个单独的区块包装出来,告诉大家“还有一种更简便的方法”,我觉得更完善学习曲线也更平滑。 4 、缺失重要概念讲解: 依旧是 004 章里的问题,if 语句部分的描述是: if 条件: 条件成立的代码块 else: 条件不成立的代码块 这个“条件”的表述不严谨,因为实际判断的不是条件本身而是计算后的布尔值。这样教很容易出现那个经典错误 if Ture = Ture ,把已经是布尔值的变量再代入一边。类似于这样为了利于理解而模糊了程序底层概念的部分,尽可能少出现。 一些小建议,辛苦 OP 编写的教程。 |
2
twinsant OP 感谢,已收录在文档里,之后改进
|