给非技术同事写说明材料，难点不在于讲清原理，而在于让对方知道什么时候该用、什么时候不该用。材料里出现协议名称和参数只会增加距离感。以代理IP为例，一页说明只要覆盖用途、边界、流程三块，对方就能独立判断。
一页材料的三块内容
第一块写用途，列出哪些任务需要它，用具体的动作描述，比如按地区核对页面展示。第二块写边界，写清哪些任务不要用，比如涉及账号登录和对外提交。第三块写流程，说明遇到问题找谁。三块内容加起来不超过一页，非技术同事看完就能上手。
- 第一块：哪些任务需要它
- 第二块：哪些任务不要用
- 第三块：遇到问题找谁
- 末尾：常见误解一句话澄清
写材料时要用动作描述，不要用技术名词。写成按地区核对页面展示，对方立刻明白；写成配置出口参数，对方只会跳过。免费代理IP这类工具在非技术岗位的使用，本来就依赖清晰的场景描述，描述不清就等于没有说明。
常见误解怎么澄清
最常见的两个误解是能提速和能保证稳定。材料里用一句话说明即可：它换的是来源，不是速度，也不保证一直可用。把这两点写在开头比写在末尾有效，因为同事往往只看前几行。说明里也要写清代理IP的适用条件，写清了才执行得下去。
材料要不要做成问答
问答形式比段落形式更好用，因为同事通常是带着具体问题来查的。把最常被问到的几个问题列出来，配上一两句回答，查起来比通读一段文字快得多。
说明要不要配图
说明里放一张链路简图比放界面截图好，简图不会过期，也能帮人建立整体印象。截图虽然直观，但界面一变就得重做，维护成本明显更高。
材料谁来写
由实际使用的人来写，比由管理者写更贴近真实场景。使用的人知道哪些地方容易卡住，也更容易把边界写准，写出来的材料才经得起日常检验。
材料放在哪里
放在同事日常会打开的位置，比如团队文档首页或者常用工具的说明旁边。放进邮件附件或者会议资料里，实际使用的时候不会有人去找。免费代理IP的使用场景零散，材料放在手边才有机会被用到，这一点对代理IP这类零散使用的工具同样成立。
先写场景，再写原理。
给非技术同事讲什么是代理IP，用一页材料写清用途、边界、流程，比讲原理更有用。