格雷格·皮特曼

这是一个愿景：如何制作一个优秀的教学大纲，以至于无需正式修读该课程？ 在现实世界中，您摆脱了时间表和学分的象棋游戏，有时您只想学习一些东西。 即使您仍然在玩这个游戏，您也只有那么多的时间表，可以参加的课程数量，以及您将投入“官方”教育的某个时间段。 实际上，我们中的许多人想要并且需要终身教育。

我想提出的几点是首先尝试赋予文档除了初始阅读之外的生命。 换句话说，它也应该作为复习参考，以便有多个入口点，甚至一些快速的即时提醒用途。 因此，明智地使用标题和索引会有所帮助。
其次，尝试创建具体且可用的示例（以及大量示例）。 我见过太多的“foo”和“bar”。 向我展示一些实际完成某种真实世界任务的东西，即使它很小。