前天翻新文档的时候突然发现，之前写的自然嵌入PC端说明漏了两条关键内容，第4、5条关于平台属性的定义压根没说清楚。这玩意儿要是不补上，以后开发接入准得掉坑里。
打开旧文档一看
我先把之前的文档翻出来瞅了瞅，好家伙前三条写得跟shi一样。第一条说安卓要填应用包名，第二条iOS要填BundleID，第三条PC端写个“见技术指导”就没了。平台属性那栏直接空着，这不是挖坑等别人跳吗？
改文档前先自己试错
怕误人子弟，我干脆先开项目测试。打开新版文档框架，在平台属性那栏试着填“PC端”。提交完跑测试包，结果SDK初始化直接报错500。后台日志显示字段校验失败，这破平台压根不认识“PC端”仨字。
翻源码才搞明白
- 蹲电脑前折腾半天，直接扒SDK源码
- 发现校验逻辑里藏着关键提示：平台参数只认全大写
- 所有平台字段都得走大写缩写路线
立马把“PC端”改成大写的“PC”，重新打包上传。这回测试包跑起来特顺溜，数据上报后台也查到了，参数对得整整齐齐。
第5条更是离大谱
测试完第4条刚要歇会儿，突然发现第5条写的是“服务端接收字段见API文档”。这话等于放屁，接口文档翻三遍都没找到对接字段说明。我TM直接气笑，抄起电话就打给后端组。
结果人家在电话里也懵：“这字段三年前就废弃了！现在都改用meta_field传平台参数”。好家伙，合着文档和代码各活各的。
改文档还得防手贱
- 把废弃字段全划掉标红
- 新字段用加粗大字号标在文档最前面
- 顺手加了行备注：“乱填后果自负”
搞完发给测试组小哥验证，他对着文档半小时就跑通了流程。所以说，写文档不能当甩手掌柜，自己踩过的坑才是真干货。这玩意儿以后谁敢乱填？反正老子不敢了。
