写文档的技巧

用户以 F 状的方式阅读网页,先看前三行,然后垂直向下阅读,只看每一行的前几个字。

所以,写作的时候,应该注意下面几点。

  • 第一段和第二段必须给出最重要的信息,而且第一句话最重要。
  • 标题、段落、列表的开头,都应该立即给出信息。
  • 通过字型的变化(大小、黑体、链接),把用户的注意力吸引到重点句子。

https://blog.stoplight.io/writing-documentation-when-you-arent-a-technical-writer-part-one-ef08a09870d1