技术写作与文档2022niemanlab.org
为韦布望远镜照片撰写替代文本的科学家访谈
Interview with the scientist who’s writing the Webb photos alt text
导读
这是 Nieman Lab 对一位科学家的访谈：她负责为詹姆斯·韦布空间望远镜拍下的照片撰写替代文本（alt text），把人类从未见过的宇宙图像转成文字。对写作者来说，这是一个极好的练习：如何在看不见图像的前提下，用文字准确传达信息与感受，并兼顾不同读者与无障碍需求。评论还顺带讨论了术语选择的问题，也值得思考。
可以直接用的写作要点
- 01
为图片写替代文本时，先问“读者需要知道什么才能获得同等信息”，再动笔，不要把画面里的每个细节都罗列一遍。
- 02
面对陌生或超出日常经验的事物（如天文照片），要用读者已有的经验做类比，并交代尺度与背景，否则形容词再华丽也是空的。
- 03
面向公众写作时，慎用行业内部术语；像“alt text”这样的缩写在专业圈通用，对普通读者却可能完全陌生，必要时先解释再使用。
- 04
把“描述”与“解读”分开：先说画面上有什么，再说明它意味着什么，读者才能自己判断。
HN 评论精选
术语要按读者选：面向客户或外行时，用更直白的说法代替圈内缩写。
“alt text”这个说法是普通人能懂的俗语吗？我在跟客户交流时一般说“text alternatives”（文本替代方案）。它其实是一个具体的属性，将来也可能被 `aria-label` 之类的取代。
curlftpfs查看英文原文
Is "alt text" a colloquialism understood by laymen? I typically use the term "text alternatives" when speaking with clients. It's a specific attribute, it might be supplanted by `aria-label`, etc https://www.w3.org/WAI/WCAG21/Understanding/conformance#text-alternatives
同类还值得读
编写更好文档的框架
A Framework for Writing Better Documentation
这是 Divio 的文档写作框架，把技术文档按「读者的目标」分成四类：教程（学习导向）、操作指南（问题导向）、参考（信息导向）、解释（理解导向）。
技术写作与文档2021 · 637 分 · 76 评4 条写作要点编辑精选写好一份设计文档
Writing a good design document
这篇 HN 帖子标题为《Writing a good design document》，主题是如何写好一份设计文档；对写作者来说，它值得作为技术写作和结构化说明文的参照。
技术写作与文档2025 · 581 分 · 147 评3 条写作要点编辑精选技术写作课程
Technical Writing Courses
这是 Google 官方免费技术写作课程（两门），讲受众定义、主动语态、短句、文档结构等基础方法。
技术写作与文档2020 · 571 分 · 73 评4 条写作要点编辑精选写出更好的错误信息
Write better error messages
这篇帖子讨论如何写出更好的错误信息，评论补充了开发者场景下的具体做法和真实反面案例。
技术写作与文档2022 · 566 分 · 253 评4 条写作要点编辑精选写一本技术书的经济账
The Economics of Writing a Technical Book
一位技术书作者拆解写书的真实经济账：版税收入往往远低于投入的时间成本。
技术写作与文档2018 · 519 分 · 149 评4 条写作要点编辑精选