知识卡片
稳定模板减少阅读适应成本
重复出现的结构让读者知道到哪里找前提、正文和参考,作者也可从脚手架开始而不用每次重新设计。模板应对应文档类型和真实任务,不能要求每个栏目都填无用内容;形式一致服务于快速定位,不能替代准确事实。原书用维基百科作比方,不表示所有页面布局从来相同。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第9章 文档化你的项目 9.1.7 使用模板 · 查看原书依据
使用模板强制文档的通用模式
参考来源
- 位置:《Python编程精进(第1辑)(套装共3册)(异步图书)》Python高级编程(第2版) · 第9章 文档化你的项目,spine018单元009;来源项目book-sources,extracted/Python编程精进(第1辑)(套装共3册)(异步图书)/_epub-src/OEBPS/text00017.html。
- 结论依据:原文用模板保持通用模式,支持读者可预期的栏目位置;形式共同并不提供事实准确或每栏都有必要的证据。未在本机运行示例或改变环境。
- 原始内容:习维基百科的方式可以让你更高效。 因此,使用模板强制文档的通用模式,可以使人们更有效地使用它们。他们习惯了结构,知道如何快速阅读它。 为每种文档提供模板还为作者提供了一个快速开始的脚手架。