← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 2140.g

简洁是技术写作核心

理解等级:未标注

读者不是来欣赏文学创造力,而是要理解内容,因此字数越少越好——团队内部编辑通常能减掉20%~30%的字数,”无一分可增不叫完美,无一分可减才是”对技术文章和代码同样适用。检验文章是否自包含的方法是”作家研讨会”:与会者阅读讨论文章,作者只能旁听不能发言,无法靠口头解释弥补没说清楚的地方——这种”被迫沉默”最能暴露文章哪里没写明白。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 沟通 3.2 写给大忙人 · 查看原书依据

      会议期间,与会者会阅读和讨论某篇文章,作者只允许旁听,但不能发言。这种会议模拟了一群人在阅读和讨论一篇文章的情景,同时也能检验这篇文章是否为自包含的。

    参考来源

    - 位置:《架构师应该知道的37件事》第3章《沟通》之"3.2 写给大忙人"·"3.2.7 简洁明了"与"3.2.8 作家研讨会"(源文件:_epub-src/OEBPS/Text/chapter003.html) - 结论依据:原文说明"我们团队内部的编辑环节通常能减少20%~30%的字数……作者只允许旁听,但不能发言。这种会议模拟了一群人在阅读和讨论一篇文章的情景,同时也能检验这篇文章是否为自包含的",直接支撑本卡结论。 - 原始内容:第一次看到这个可能会让你震惊,但是Saint-Exupéry7说过,“无一分可增不叫完美,无一分可减才是”,他的这句名言对技术文章(以及这方面的优秀代码)而言尤其适用。