知识卡片
排比句式、单一主题段落、消灭悬空指代
内容
排比句式要求列表各项遵循同一语法结构(都以动词或形容词开头),反例”它更快/灵活度/我们想要降低成本/稳定”混用了动词、名词、句子,让读者耗费脑力解析文本而非专注内容。每个段落只讨论一个主题,且开门见山介绍主题,让读者能一眼判断是否需要细读。技术主题不是线性的,但文本必须线性排列——每个列表或分组都要依据明确的顺序(时间/结构/等级),”字母顺序”和”随机顺序”不是有效选择;同时要消灭无具体指向的”这”,就像程序员避免悬空指针一样。此外,陈述句应先给出读者不知道的信息、让他们自己在脑海里产生疑问,再由作者解答——先别让读者带着疑问却等不到答案。
结构图:
flowchart TB
A["排比句式:同一语法结构"]
B["单一主题段落:开门见山"]
C["文本线性化:按时间/结构/等级排序"]
D["消灭悬空的'这':明确指代对象"]
E["先陈述事实,后回答疑问<br/>不要让读者带着疑问却等不到答案"]
A --> F["降低读者解析成本"]
B --> F
C --> F
D --> F
E --> F
参考来源
- 位置:《架构师应该知道的37件事》第3章《沟通》之"3.2 写给大忙人"·"3.2.5 让读者轻松些"与"3.2.6 写作曲线——线性化"(源文件:_epub-src/OEBPS/Text/chapter003.html)
- 结论依据:原文说明"排比句式要求列表中的各项必须遵循相同的语法结构……每个列表或者分组都应该有要依据的顺序……'字母顺序'和'随机顺序'不是有效的选择……Jeff Ullman把这种'无指向性的这'看作清晰写作的主要障碍之一",以及明托关于"先陈述后回答疑问"的建议,直接支撑本卡结构图。
- 原始内容:通过陈述告诉读者一些他们不知道的事情,他们在脑海里会自主地提出疑问……此时,作者就有责任回答问题了。