给团队写一份IP代理工具的使用说明，最容易犯的错是写成产品介绍：写了很多它是什么，却没说清楚拿到手该怎么做。使用说明的读者是要动手的人，他们关心的是操作与边界，不是概念。
必须交代的四项
第一项是接入信息在哪里、怎么填。第二项是哪些任务走哪一组资源，最好配一张对照表。第三项是出现异常时先看什么、找谁。第四项是哪些做法不允许，避免有人为了图快把规则打破。这四项覆盖了日常使用中绝大多数会卡住的地方，写全了能省下大量重复答疑。
- 接入信息与填写位置
- 任务与资源的对应关系
- 异常时的第一处理动作与联系人
- 明确不允许的做法
代理IP工具使用说明的价值，在于让没问过的人也能照着做对。判断写得好不好有个简单办法：找一个没参与过的人，让他照着说明独立跑一遍，卡在哪里就补哪里。IP代理工具这类涉及位置与规则的说明尤其如此，写的人觉得理所当然的地方，往往正是新人最容易出错的地方。
不要写进去的内容
原理性的长篇解释、内部的取舍讨论、以及只适用于某一次任务的临时做法，都不必写进正式说明。这些东西看着有用，实际会让文档变长变旧，读者也找不到重点。原理可以单独放一份背景材料，需要的人自然去看。
需要注意的是：说明写完之后要有人维护。位置清单变了、规则调整了，文档跟着改一次，成本很低；放着不改，半年后就没人敢照着它做了。
异常提交的格式
说明里还有一项容易被漏掉：写清哪些做法会带来麻烦。比如随手上报一个「大概在某个地区看不了」，既没说具体位置也没说时间，接手的人只能重问一遍。把提交代理IP问题的格式固定下来，代理IP工具的异常处理才能形成闭环，不会每次都从「你先描述一下情况」开始。
写给动手的人看。
一份好的IP代理工具使用说明，把接入、对应、异常、禁区四项交代清楚，比写十页原理都有用。