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

• 資深大佬 : 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

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

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

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

• 資深大佬 : gstqc

  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 不是所有的程序员都这样