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

2023-11-21 00:23:23 +08:00
 alanhe421

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

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

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

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

2091 次点击
所在节点    程序员
11 条回复
kkwa56188
2023-11-21 00:30:31 +08:00
的确 不太上心.

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

那只能说真烂/真冷门
lll5758
2023-11-21 10:16:06 +08:00
这个犯错太正常了,写文档的一般都是集中大批量写,有时候你就是看不出问题,别人一眼能看出问题,你提问题就行了,
huihuiHK
2023-11-21 10:21:03 +08:00
时间紧,任务重,赶鸭子上架
GeekGao
2023-11-21 15:31:10 +08:00
字节、阿里,文档都不太好,可能是 996 搬砖太累了。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/993660

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX