收藏
回答

希望官方能够重视小程序文档的建设,补全小程序开发文档?

在日常开发中,避免不了频繁查小程序文档,发现有部分api的属性说明不够清晰或者缺失的情况,

例如: wx.request (https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html

这个api总共有三个回调函数(successfail, complete),但是文档只对 success 回调函数的参数做出了说明, 对 fail complete 回调的参数无任何说明文档,需要开发者实际操作才知道。

(需要的是回调函数的参数说明),如下:


还比如我之前提出的问题:https://developers.weixin.qq.com/community/develop/doc/0000607a21cfc86d1a690d0e351000,也是文档不全导致开发者无法确定参数返回

文档api或者组件使用说明不清晰不止有上面两个例子,大量普遍的出现在文档中,希望官方能查阅一遍文档,对改补全的参数说明进行补充。

希望官方能够重视小程序文档的建设,希望小程序发展越来越好!

最后一次编辑于  2019-11-21
回答关注问题邀请回答
收藏

25 个回答

  • 连胜
    连胜
    2019-11-21

    这个问题提的专业,经常在fail里面摸不着头脑,然后只能在代码里面上报日志,通过分析日志,再对代码做进一步的判断逻辑~

    2019-11-21
    有用 27
    回复 9
    • 连胜
      连胜
      2019-11-21
      有时候每个机型返回的错误还不一样,或者是不同的基础库版本返回错误也不一样,比如deny和denied就是出现在不同的基础库版本中,不踩坑就不知道。
      2019-11-21
      2
      回复
    • 三省
      三省
      2019-11-21
      对呀,文档中很多参数的说明不够清晰,导致开发者需要实际操作尝试,这样造成有时候会有遗漏的参数或者字段出现,导致线上bug
      2019-11-21
      回复
    • 北方有相思。
      北方有相思。
      2019-11-21
      对开发进度影响很大,所以完整的文档是必要的,对于新手有案例就更好啦
      2019-11-21
      回复
    • 维他柠檬茶呀
      维他柠檬茶呀
      2019-11-21
      占个位,官方文档有很多坑,希望可以多多补全.
      2019-11-21
      回复
    • showdown
      showdown
      2019-11-21
      跪求更新完整
      2019-11-21
      回复
    查看更多(4)
  • 陈式坚
    陈式坚
    2019-11-29

    讲个实际的事情

    公司来了实习生,在做小程序的之前,和他千万不要看小程序文档。只有查Api的时候才让他查。

    本来好好的,但是有一段时间太忙,没有和他对接。他自己不信邪偷偷去看文档,结果现在脑子全乱了...

    他说

    1. 为什么文档写的看不懂,例如wxs写touch事件这个

    2. 为什么api的使用逻辑和自己想的差很多,例如明明写success,以为是成功返回数据,没想到居然是成功调用接口,给我连续打了3个黑人问号

    3. 搜索根本没用,什么也找不到,例如想找获取用户收货信息,搜索框搜索address,完全没有出现

    4. 文档的结构看不懂,每次都重新到处翻

    5. api文档内容太简陋,看完还是不知道怎么用

    6. ...

    看vue他用了2天就大致理解会用,结果栽在小程序上了,我遗憾的和他,「没事,我也是这么过来的」

    2019-11-29
    有用 3
    回复 3
    • 三省
      三省
      2019-12-03
      未改版前的文档要详细很多,这个新版的精简了
      2019-12-03
      回复
    • 三省
      三省
      2019-12-03
      以前的有很多使用示例,现在的很多示例没了
      2019-12-03
      回复
    • 卍卍槑想到
      卍卍槑想到
      2020-05-29
      娇华运营会怼你爱用不用的,顺带一句提问的艺术
      2020-05-29
      回复
  • 龙@CYBERSPACE
    龙@CYBERSPACE
    2019-11-21

    顶一下~

    2019-11-21
    有用 2
    回复
  • 疯狂的小辣椒
    疯狂的小辣椒
    2019-11-21

    https://developers.weixin.qq.com/community/develop/doc/00008443130560da55386506856800

    需求已在开发计划中。

    2019-11-21
    有用 2
    回复 6
    查看更多(1)
  • G-STEPS街舞工作室
    G-STEPS街舞工作室
    2019-11-21

    用 typescript 一定程度上可以缓解这问题。不过完整的文档还是必须的

    2019-11-21
    有用 1
    回复 2
  • 2020-05-21

    微信,请对开发者好一点

    2020-05-21
    有用
    回复
  • 等我想好再说
    等我想好再说
    2019-11-29

    赞同 赞同  每次让开发者去实验,这样不好,有的时候有bug。工具端和真机调试的回调结果还不一样,就会让开发者感到很懵。

    2019-11-29
    有用
    回复
  • 放学别跑
    放学别跑
    2019-11-21

    老三, 大哥帮你顶起来.  文档还是越详细越好, 省的大家都来问

    2019-11-21
    有用
    回复
  • 浅忆青空
    浅忆青空
    2019-11-21

    三爷,小弟前来膜拜

    2019-11-21
    有用
    回复
  • 一点一滴
    一点一滴
    2019-11-21

    2019-11-21
    有用
    回复

正在加载...

登录 后发表内容
问题标签