分类频道
技术写作
该分类下的文章、提问与讨论帖。
discussion
技术文档该写到「什么程度算够」：细节堆满还是留白给读者？
背景 做了 8 年技术文档，最近复盘自己经手过的项目文档，发现一个反复出现的尴尬：同一份「接口接入指南」，有人看完直接上手跑通了，有人看完还是来问「这一步到底点哪里」。差别往往不在读者能力，而在文档的颗粒度——它决定了读者能自己走多远。 我