V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
alanhe421
V2EX  ›  程序员

阿里云-通义千问 文档好歹认真点啊-参数 typo

  •  
  •   alanhe421 ·
    alanhe421 · 2023-11-21 00:23:23 +08:00 · 2063 次点击
    这是一个创建于 367 天前的主题,其中的信息可能已经有所发展或是发生改变。

    https://i.imgur.com/pXIsjrd.jpg

    https://i.imgur.com/Wi3Ka7o.jpg

    choice 写成了 choise ,我说为啥调用总报空异常,debug 发现是该错。实际调用测试返回是 choice ,例子是对的

    肯定不止通义千问,只是毕竟是最近出的东西,仔细点啊。

    看到这个错误也想起,team 有时候内部也发现这类好多错误,除了细心之外,还是建议用带拼写检查的编辑器写,多少会好些。

    文档地址: https://help.aliyun.com/zh/dashscope/developer-reference/api-details?spm=a2c4g.11186623.0.i0#58595f510c3zl

    11 条回复    2023-11-21 15:31:10 +08:00
    kkwa56188
        1
    kkwa56188  
       2023-11-21 00:30:31 +08:00
    的确 不太上心.

    我还发现一个小问题: 描述栏里 有时候用了标点, 有时候不用, 没有统一.
    例如 :
    "本次请求算法输出内容的 token 数目。"
    vs
    "本次请求的系统唯一码"
    dayeye2006199
        2
    dayeye2006199  
       2023-11-21 01:30:11 +08:00 via Android
    程序员加班加点写文档亚历山大
    hefish
        3
    hefish  
       2023-11-21 08:09:53 +08:00
    国内项目的文档,这样已经算还行了。 凑合吧。 其实老外的文档也有偶尔拼错的。 大家宽容些。。。
    给他提个 issue
    zcybupt2016
        4
    zcybupt2016  
       2023-11-21 08:57:44 +08:00
    这两天接阿里云的人脸验证,官方 demo 还有通过类名直接调非静态方法的呢,这种 typo 至少倒还不影响运行
    weilongs
        5
    weilongs  
       2023-11-21 09:02:32 +08:00   ❤️ 1
    难道他们的文档不能用通义千问整理一下?
    alanhe421
        6
    alanhe421  
    OP
       2023-11-21 09:36:19 +08:00
    @dayeye2006199 如果是视作打工人额外多做的,那确实要多份理解。
    alanhe421
        7
    alanhe421  
    OP
       2023-11-21 09:38:01 +08:00
    @zcybupt2016 你这确实严重的多,毕竟这是对外服务的 Demo ,不是个人自己玩的
    alanhe421
        8
    alanhe421  
    OP
       2023-11-21 09:39:45 +08:00
    @kkwa56188 不是还开发布会,然后这边还犯显著错,又不是”冷门“的服务。

    那只能说真烂/真冷门
    lll5758
        9
    lll5758  
       2023-11-21 10:16:06 +08:00
    这个犯错太正常了,写文档的一般都是集中大批量写,有时候你就是看不出问题,别人一眼能看出问题,你提问题就行了,
    huihuiHK
        10
    huihuiHK  
       2023-11-21 10:21:03 +08:00
    时间紧,任务重,赶鸭子上架
    GeekGao
        11
    GeekGao  
       2023-11-21 15:31:10 +08:00
    字节、阿里,文档都不太好,可能是 996 搬砖太累了。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1101 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 43ms · UTC 22:58 · PVG 06:58 · LAX 14:58 · JFK 17:58
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.