去除模棱两可的措辞,避免使用被动语态,消除重复内容

主要观点:

  • 指导博士生写作困难,作者用 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”模式受此启发。
阅读 8
0 条评论