thoughtwork出品《技术写作手册》--读书笔记

写作为为什么这么难

• 因为大多数人觉得不值，不会去坚持，如果给500万写博客，在所有理由上都不是问题

为什么其他事情会自觉地去做：

• 快速的得到正向反馈、相对容易举例说明的故事：常说的培养兴趣，实际应该促使让小孩获取某方面的成就，让他觉得自己比别人强，谈到夸奖、小朋友的羡慕 就会越喜欢，兴趣自然而然就有了，就会更自觉的做。

写作难的解决思路

• 能否找到一种适合自己的鼓励方式，能让我们自己在做这件事情的时候，能够得到持续快速的正反馈，并尽量把这件事情变得容易，

一个优质的内容它具有以下特点：

1. 明察洞悉，清楚地看到，透彻的了解，能引起强烈共鸣，但不带节奏
2. 能透视不易察晓的事物，看透本质，高明的见解
3. 人无我有，人有我优，人优我精，人精我绝

写作的基础：

• 认清写作的是给自己看，还是给读者看，如果是给自己看，不同人群写作内容会不同写作的要求：  写出来后，需要思考我应该如何通过最通俗易懂的表述，让他们理解我想表达的概念

写作不怕：

不怕不友好的评论，

写作前的思考：

1. 我想传达什么讯息？
2. 我的目标受众是谁？
3. 读完以后，希望受众做点什么？
4. 明白写作的意义：提升自己、结识好有、写作能力创新开始你的

动笔时你需要构思：

• 脑力劳动：素材架构、构思、立意、大纲过程 
• 体力劳动：码字、排版、修改、

发布写完后做的三件事

• 发布前看三遍，第一遍看内容结构，第二遍看遣词造句，第三遍代入读者视角

技术人员如如何写一本书

• 其中有章节详细讲到，如何写书、以及博客与书籍的区别、存在的问题、如何发布书籍、电子书、实体书的差异

写书潜在的问题：

• 错别字：写作人很难发现，读者很容易发现、   
• 排版：电子书籍会更让快速发现问题写书最大的感受

笔者写书最大的感受：

• 当你制定了一个目标，不论这个目标开始开起来有多么的不切实际，一旦你开始细化这个目标并逐步实施，你就已经离这个目标不远了。当然，和每个任务一样，事情走到最后可能会和最开始的目标并不完全契合，但这大约是我们无法掌控的那部分了，就随他去吧。

用什么工具写书

• Word：相对比较容易掌握，所见即所得，但较难进行版本管理。
• Markdown：程序员用的较多，纯文本，有很多可视化工具，方便进行版本管理。
• Latex：科研论文用的较多，纯文本，能够做出很专业的文档，但学习成本、配置成本较高

优秀文章的加分项争议性话题。

1. 博取眼球不是重点，重点在于引起的讨论和更多观点的输出，抛砖引玉。总结性经验。
2. 带有“N 个 XXX”字样的标题总是会吸引人关注并收藏。洞见性观点,独特的视角，执拗的语调，让人感同身受的情绪，让我们的内容区别于其他那些平淡无奇，味同嚼蜡的文章。
3. 故事性描述。 引人入胜的故事，胜过波澜不惊的叙述，总是更能在现在注意力缺失的阅读中，吸引读者更多

文章的表面功夫 (我更觉得是文章的排版要求）

1.排版

• 尽可能使用短句，使用 3-5 行以内的小段落。
• 对文字按需适当加粗，并适时引用外部文字。
• 正确使用标点符号，多尝试使用（无）编号列表。
• 中英文混居，英文单词前后留半角空格。
• 一篇文章中出现的颜色、字体、字号等最好不要超过 3 种。经常看到一些文章用 N 种字体和颜色来标示重点内容，效果适得其反。不仅没起到强调的作用，反而给人一种很混乱的感觉。
• 段首缩进在互联网时代已不是必需，留段间距的方式来保持段落之间的层次感，保证良好的阅读体验。
• 排版体现呼吸感，特别要提出的是考虑针对移动阅

2 图片

• 在不影响表达效果的前提下，建议少用图片。现在读者大多用移动设备浏览文章，非重要图片的过度使用会导致文章浏览量下降。
• 和谐、完美的版式效果依赖于合适的图文比例。尽量避免大篇幅独句成段、图片高频率出现等问题。以一个读者的视角来把握图文比例。
• 需要看清楚其上文字的图片一定要清晰，否则建议用文字描述代替图片展示。
• 图片上加文字时，尽量从图片中吸取一个恰当的颜色来设置文字颜色

最后以文章引用结尾，可能是感觉很有共鸣

如何获得书籍，关注thoughtwork公众号