obaby@mars
·
哥哥，不会写文档就 tm 别写，老老实实写代码行吗？
💡
原文中文，约1300字，阅读约需4分钟。
📝
内容提要
作者对厂商提供的对接文档不满，文档不详细，实例代码不全，测试设备没有反馈错误二维码。作者遇到设备上线问题，厂商升级加密算法但未提供密钥。作者自己写了二维码生成算法，但设备无法识别。项目经理提供了可用的二维码，作者发现厂商的加密代码实际上是解密代码，加密代码未给出。作者批评厂商写文档不专业，浪费了四五个小时。
🎯
关键要点
-
作者对厂商提供的对接文档不满，认为文档不详细，实例代码不全。
-
测试设备未能反馈错误二维码，导致设备上线问题。
-
厂商升级加密算法但未提供密钥，作者不得不自己编写二维码生成算法。
-
设备无法识别作者生成的二维码，项目经理提供的二维码有效。
-
作者发现厂商的加密代码实际上是解密代码，未提供正确的加密代码。
-
作者批评厂商文档不专业，浪费了四五个小时的时间。
➡️
