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

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

Recommended Services

› Amazon Web Services

› LeanCloud

› New Relic

› ClearDB

这是一个创建于 1354 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

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

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

第 1 条附言 · 2021-03-29 15:14:32 +08:00

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

文档

云全站

WebSocket

更新

47 条回复 • 2021-03-29 20:06:28 +08:00

7654

2021-03-28 17:41:37 +08:00

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

cubecube

2021-03-28 17:46:29 +08:00

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

killergun

2021-03-28 17:47:35 +08:00

看看微软的文档

risky

2021-03-28 17:48:02 +08:00

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

echowuhao

2021-03-28 17:55:13 +08:00

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

dream7758522

2021-03-28 18:04:23 +08:00 via Android

哈哈，腾讯小程序的文档

yigecaiji

2021-03-28 18:07:08 +08:00 via Android

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

kingfalse

2021-03-28 18:13:07 +08:00 via Android

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

AndyAO

2021-03-28 18:19:25 +08:00

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

littlewing

2021-03-28 18:22:14 +08:00 via iPhone

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

7654

2021-03-28 18:46:47 +08:00

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

seakingii

2021-03-28 18:48:16 +08:00

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

zlowly

2021-03-28 19:01:43 +08:00

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

hoyixi

2021-03-28 19:09:03 +08:00

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

echowuhao

2021-03-28 19:49:16 +08:00 via Android

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

suifengdang666

2021-03-28 20:03:08 +08:00

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

realpg

2021-03-28 20:33:45 +08:00

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

flineqaq

2021-03-28 20:34:59 +08:00

因为上行下效啊

westoy

2021-03-28 20:36:45 +08:00

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

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

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

0ZXYDDu796nVCFxq

2021-03-28 20:44:24 +08:00 via Android

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

zhangshine

2021-03-28 21:48:02 +08:00

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

Lxxyx

2021-03-28 22:03:29 +08:00

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

hotsymbol

2021-03-28 22:07:11 +08:00

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

R0n1n

2021-03-28 22:15:55 +08:00 via Android

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

opengps

2021-03-28 22:22:57 +08:00 via Android

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

Chingim

2021-03-28 22:40:45 +08:00 via iPhone

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

easylee

2021-03-28 22:41:57 +08:00

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

sytnishizuiai

2021-03-28 22:46:19 +08:00

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

jadec0der

2021-03-29 07:23:39 +08:00

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

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

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

touchwithe

2021-03-29 08:08:06 +08:00 via iPhone

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

stardustree

2021-03-29 08:41:57 +08:00

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

dvaknheo

2021-03-29 08:49:05 +08:00

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

stardustree

2021-03-29 10:43:16 +08:00

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

wangyzj

2021-03-29 11:19:50 +08:00

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

Zzzz77

2021-03-29 11:56:08 +08:00 via Android

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

lefer

2021-03-29 12:43:17 +08:00

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

lp10

2021-03-29 12:46:29 +08:00

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

starkwang

2021-03-29 13:55:51 +08:00

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

sansanhehe

2021-03-29 14:09:38 +08:00

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

AIFNI45Mdxn

2021-03-29 14:53:05 +08:00

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