在日常开发中,避免不了频繁查小程序文档,发现有部分api的属性说明不够清晰或者缺失的情况,
例如: wx.request (https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html)
这个api总共有三个回调函数(success,fail, complete),但是文档只对 success 回调函数的参数做出了说明, 对 fail 和 complete 回调的参数无任何说明文档,需要开发者实际操作才知道。
(需要的是回调函数的参数说明),如下:
还比如我之前提出的问题:https://developers.weixin.qq.com/community/develop/doc/0000607a21cfc86d1a690d0e351000,也是文档不全导致开发者无法确定参数返回
文档api或者组件使用说明不清晰不止有上面两个例子,大量普遍的出现在文档中,希望官方能查阅一遍文档,对改补全的参数说明进行补充。
希望官方能够重视小程序文档的建设,希望小程序发展越来越好!
顶一下~
赞同
文档完善下对开发者更友好~
顶,越来越完善
顶一下
顶一下,文档很重要,需要我们共同建设!
顶一下!
赞同!
哈哈,文档确实很重要,不完整很容易跑偏