为什么云厂商不更新文档，非得售后人工服务问才有结果。

[echowuhao]

比如，阿里云全站加速，之前没有开 websocket, 但是留意好像有。开去了找不到，然后问了半天，要企业认证，要申请。

文档在此： https://help.aliyun.com/document_detail/145585.html

帖子做记录看看什么时候文档会更新。

参见#40 楼 文档已经更新 为阿里云点赞 24 小时内更新成功

[7654]

这是套路吧，告诉你有，但是不告诉你怎么才能拥有，非要注册使用后才说限制条件

[cubecube]

@7654 并不完全是套路。完全就是规模和数量太多，很难保持一致导致的。阿里云这块还算做得比较好的。
很多产品开发和文档是两个部门在弄，工作节奏不一致，而且产品太多了，有时候内部都不清楚最新的版本是啥，都要拉群问的。

[killergun]

看看微软的文档

[risky]

感觉阿里云的文档稀碎，官方也有不少实习生 SDK，不是写得差的那种，是根本就有错误

[echowuhao]

@cubecube 规模是一个因素，这个是个管理的问题，更新了 feature，然后更新文档。问了半天，他们也没少花时间，我也浪费了时间。

[dream7758522]

哈哈，腾讯小程序的文档

[yigecaiji]

想到每次用阿里的 docker 源的时候都要找很久。

[kingfalse]

阿里的文档各种 bug，官方的 demo 各种跑不通

[AndyAO]

微软的文档好像做得很不错，是开源的，可以提交 Pull Request，错误可能会少点吧。

[littlewing]

程序员最讨厌的两件事
1. 别人的项目没文档
2. 给自己的项目写文档

[7654]

@cubecube #2
@echowuhao #5
https://www.aliyun.com/price/product#/dcdn/detail
上面的是收费说明，全篇只有在预付费资源包一栏有强调实名认证用户可购买资源包

[seakingii]

国内厂商普遍不重视文档。

[zlowly]

没错，国内厂商不重视文档是普遍现象。用过几个国内大厂的出品，那文档滞后不谈，而且内容简陋，歧义甚多，不注册官网就基本没在线手册，手册版本不全，API 、程序范例出错漏更不鲜见。
不要说程序员最讨厌写文档，对比一下国外随便一个成熟产品都比它们做得好，他们的程序员就不是程序员了？

[hoyixi]

限制条件一开始就说，怎么吸引脑袋热的下订单

[echowuhao]

@7654 我是实名 但是售后说必须企业认证 然后提交用途说明审核之后才可以

[suifengdang666]

个人实名用户，去年 12 月开的全站加速 DCDN websocket 功能，全程自助开通，无需工单

[realpg]

@zlowly #13
注册了就有手册就知足吧。。。
有些国内项目，简介里啥都有，要看手册要注册，实名认证
认证完了告诉你没这个功能

[flineqaq]

因为上行下效啊

[westoy]

厂家一开始就做， 后来慢慢做废掉的一般只有两种状况

厂家不希望小客户用， 人为制造学习和沟通障碍

一种是真的没多少人用， 没必要浪费人力成本在这上面

[0ZXYDDu796nVCFxq]

2B 的基因问题吧
看微软 Google oracle

[zhangshine]

成本高，程序员都 996 写 bug 了，那有时间写文档

[Lxxyx]

因为国内的考核机制是要求出“花活”才能加薪晋升，而不是写文档这种“大家都会”，“没有价值”的事情（手动狗头）

[hotsymbol]

不懂就问不是中华传统美德吗？

[R0n1n]

文档都弄好了，客服部门的 KPI 怎么办？

[opengps]

阿里云对于文档缺失，错误，等情景是有奖励的，登录聆听平台反馈，没事赚个单品类无门槛代金券之类的很爽

[Chingim]

现在的情形是，写文档吃力不讨好，既占用自己的开发时间，又不被上级重视

[easylee]

就知道是 ali 系的，各种 404 和不介绍快疯了。

[sytnishizuiai]

去年我用腾讯云短信，半天就申请短信模板，写代码和测试搞定了。
上周我搞阿里云短信，php 文档多份不同的，研究了好久，才发现 17 年的才是最新的，要单独引入。模板不能申请金融的（那所有带交易的都咋办），短信情景还要我提供链接（好多业务都是下单操作后的），改了好久才通过。最后接入完了，发现没统计剩余短信的 api 。

[jadec0der]

写文档是一个很专业的事情，不是工程师写完代码顺便更新下文档。有兴趣可以去 linkedin 搜一下 aws technical writer 看一下 aws 有多少人负责写作，再点开几个人看看履历。

https://www.linkedin.com/search/results/people/?keywords=aws%20technical%20writer

没见过 technical writer 的工程师对文档的想象非常浅薄——就像煤老板对程序员的想象一样。

[touchwithe]

我司是阿里云企业大客户，售后一样是稀烂，文档万年不更新，甚至有误导内容。跟客服反馈过很多次，连错别字都没改。阿里云根本不重视这个，前端控制台也是一样垃圾。不说了，说起来就血压高。

[stardustree]

企业不重视，经历过的几家公司，文档工程师离职率都很高，关心文档质量的产品经理也是凤毛麟角

[dvaknheo]

@stardustree 文档不应该是产品的产出么？

[stardustree]

@dvaknheo 专业的公司都有专门的文档工程师，实在没人才由产品兼职，产品还可以兼职项目经理、架构师和开发呢(●ˇ∀ˇ●)

[wangyzj]

跟你不写注释一个道理么不是

[Zzzz77]

对于老板来说，写文档哪有写新功能来钱快

[lefer]

@killergun 查 Excel 的函数公式该如何使用，现在只去微软的 support 页面去查。页面内容翔实到连中文视频都有。。。

[lp10]

你是没见过美国某云服务自己 knowlegebase 各种 404 死链的。备份软件直接用的 restic，结果云服务在 restic 有自己的文档的情况下愣是把恢复操作的 source 和 destination 写反了……简直想骂人

[starkwang]

文档这东西在老板眼中只是“用户体验问题”，不产出 KPI，即使你花了大量精力把产品文档完善了，也很难量化你的产出。相比之下，做一两个新功能新平台，靠嘴皮子谈下一两个大客户，那才叫“产出”。

[sansanhehe]

泻药，人在外企，对文档的准确性要求很高，需求设计 QA 等文档都维护得很好

[AIFNI45Mdxn]

个人也可以申请开通的，只是要求比较高。我之前就开过的，不过确实需要工单审核的，我看了一下文档，不是有说明吗？ https://help.aliyun.com/document_detail/145585.html：
操作步骤：
开通 Websocket 。
目前 Websocket 功能需提交工单申请开通，并由阿里云售后专员进行审核，审核通过即可开通成功。开通成功且 Websocket 计费类型生效后，您才能正式使用 Websocket 功能。
说明 开通 Websocket 功能之前，您需要先关闭 HTTP/2 设置功能，否则会造成服务异常。关闭方法，请参见配置 HTTP/2 。
如果您是新用户，则 Websocket 计费立即生效。
如果您是老用户，且全站加速的计费类型为按日计费，则生效时间为第二个自然日零点；如果您全站加速的计费类型为按月计费，则生效时间为次月 1 日零点。”

[SlipStupig]

看过京东的文档，不看之前觉得能明白一些，看了之后完全不懂了

[echowuhao]

@AIFNI45Mdxn 恭喜你得到了它 我发帖之后改的

[cherryas]

写文档无法计入 kpi 啊

[try4times]

有个职位叫文档开发工程师，国内甚少公司有

[huobazi]

文档体现不出来 KPI 么

[abc1310054026]

写好文档真不是个容易的活, 得有专职的人来写

[iplayio2019]

@littlewing 不是所有的程序员都这样