主要观点:
- 指导博士生写作困难,作者用 shell 脚本替代自己,创建脚本检测并纠正三种写作问题(滥用被动语态、使用模糊词汇、词汇幻觉)。
- 技术写作需在精确、清晰和营销之间平衡,新研究生常出现各种写作问题,如使用盐和胡椒词、旁观者词、懒词、副词等。
- 介绍了检测模糊词汇、被动语态、词汇幻觉的 shell 脚本及用法,还将这些脚本集成到 LaTeX 文档的构建系统中。
- 提及研究生易忽视营销在写作中的作用,同行评审是科学社区有限资源的守护者。
- Benjamin Beckwith 受这些脚本启发为 emacs 贡献了“writegood”模式。
关键信息:
三种写作问题及对应的脚本:
- 滥用被动语态:如“Termination is guaranteed on any input.”可改为“A finite state-space guarantees termination on any input.”
- 使用模糊词汇:如“various”“fairly”等,可删除使句子更有力。
- 词汇幻觉:电子排版易出现重复单词,如“Many readers are not aware that the the...”
- Makefile 集成:在每个论文仓库的
bin/
目录保存脚本,添加make proof
规则来检查风格。 - 关于营销:研究生易忽视营销,同行评审决定哪些真的东西值得被关注。
重要细节:
- 检测模糊词汇脚本可自定义模糊词汇列表,通过
egrep
查找匹配词。 - 检测被动语态脚本排除一些不规则动词,通过
egrep
查找被动语态形式。 - 检测词汇幻觉的 perl 脚本通过逐行分割单词查找相邻重复单词。
- Benjamin Beckwith 的“writegood”模式受此启发。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。