通俗易懂

技术文档中不推荐使用只有特定人群才了解的语词。具体要求有:

  • 不推荐使用行话黑话、俚语、脏话等,比如“魔改”(即做特殊的优化)、“CPU 打到 60%”(即 CPU 使用率为 60%)等行话黑话

  • 不推荐使用网络流行语,比如“墙裂”、“童鞋们”等流行语中故意的谐音错别字

案例

案例一:

  • 【错误】“欢迎各位 TW 们补充你身边的案例。”

  • 【正确】“欢迎各位文档工作者补充你身边的案例。”

  • 【解释】TW 是 Tech Writer 的意思,意为(技术)文档工程师。这是技术写作领域的从业者才知道的缩略语,为了让更广泛的受众理解,建议修改。

欢迎各位补充你身边的案例。