写作和写代码有很多相似的地方, 这里说的写作是 non fiction 写作. 或者更精确来说是解释性写作. 和写代码一样, 主要的目的是让其他人能理解, 同一个段落之间的抽象层次要一致, 不可以在高抽象层次的段落里面插入包含很多细节的例子. 最好是用超链接的方式, 引用某个例子, 让读者自己决定要不要阅读细节.
写代码的 DRY (Don’t Repeat Yourself) 在写作的时候也适用, 可以用超链接把各个知识点连起来. 每个读者的思维都不一样, 作者只提供一条线性的阅读路径无法覆盖所有读者的理想阅读路径. 打散的超链接提供了相对更灵活的阅读方式, 读者可以根据自己的喜好顺序阅读, 或者跳过某些链接.