V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Recommended Services
Amazon Web Services
LeanCloud
New Relic
ClearDB
echowuhao
V2EX  ›  云计算

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

  •  1
     
  •   echowuhao · 2021-03-28 17:36:10 +08:00 · 6871 次点击
    这是一个创建于 1354 天前的主题,其中的信息可能已经有所发展或是发生改变。
    比如,阿里云全站加速,之前没有开 websocket, 但是留意好像有。开去了找不到,然后问了半天,要企业认证,要申请。

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

    帖子做记录看看什么时候文档会更新。
    第 1 条附言  ·  2021-03-29 15:14:32 +08:00
    参见#40 楼 文档已经更新 为阿里云点赞 24 小时内更新成功
    47 条回复    2021-03-29 20:06:28 +08:00
    7654
        1
    7654  
       2021-03-28 17:41:37 +08:00   ❤️ 1
    这是套路吧,告诉你有,但是不告诉你怎么才能拥有,非要注册使用后才说限制条件
    cubecube
        2
    cubecube  
       2021-03-28 17:46:29 +08:00
    @7654 并不完全是套路。完全就是规模和数量太多,很难保持一致导致的。阿里云这块还算做得比较好的。
    很多产品开发和文档是两个部门在弄,工作节奏不一致,而且产品太多了,有时候内部都不清楚最新的版本是啥,都要拉群问的。
    killergun
        3
    killergun  
       2021-03-28 17:47:35 +08:00   ❤️ 4
    看看微软的文档
    risky
        4
    risky  
       2021-03-28 17:48:02 +08:00
    感觉阿里云的文档稀碎,官方也有不少实习生 SDK,不是写得差的那种,是根本就有错误
    echowuhao
        5
    echowuhao  
    OP
       2021-03-28 17:55:13 +08:00
    @cubecube 规模是一个因素,这个是个管理的问题,更新了 feature,然后更新文档。问了半天,他们也没少花时间,我也浪费了时间。
    dream7758522
        6
    dream7758522  
       2021-03-28 18:04:23 +08:00 via Android
    哈哈,腾讯小程序的文档
    yigecaiji
        7
    yigecaiji  
       2021-03-28 18:07:08 +08:00 via Android
    想到每次用阿里的 docker 源的时候都要找很久。
    kingfalse
        8
    kingfalse  
       2021-03-28 18:13:07 +08:00 via Android   ❤️ 1
    阿里的文档各种 bug,官方的 demo 各种跑不通
    AndyAO
        9
    AndyAO  
       2021-03-28 18:19:25 +08:00
    微软的文档好像做得很不错,是开源的,可以提交 Pull Request,错误可能会少点吧。
    littlewing
        10
    littlewing  
       2021-03-28 18:22:14 +08:00 via iPhone   ❤️ 7
    程序员最讨厌的两件事
    1. 别人的项目没文档
    2. 给自己的项目写文档
    7654
        11
    7654  
       2021-03-28 18:46:47 +08:00
    @cubecube #2
    @echowuhao #5
    https://www.aliyun.com/price/product#/dcdn/detail
    上面的是收费说明,全篇只有在预付费资源包一栏有强调实名认证用户可购买资源包
    seakingii
        12
    seakingii  
       2021-03-28 18:48:16 +08:00
    国内厂商普遍不重视文档。
    zlowly
        13
    zlowly  
       2021-03-28 19:01:43 +08:00   ❤️ 3
    没错,国内厂商不重视文档是普遍现象。用过几个国内大厂的出品,那文档滞后不谈,而且内容简陋,歧义甚多,不注册官网就基本没在线手册,手册版本不全,API 、程序范例出错漏更不鲜见。
    不要说程序员最讨厌写文档,对比一下国外随便一个成熟产品都比它们做得好,他们的程序员就不是程序员了?
    hoyixi
        14
    hoyixi  
       2021-03-28 19:09:03 +08:00
    限制条件一开始就说,怎么吸引脑袋热的下订单
    echowuhao
        15
    echowuhao  
    OP
       2021-03-28 19:49:16 +08:00 via Android
    @7654 我是实名 但是售后说必须企业认证 然后提交用途说明审核之后才可以
    suifengdang666
        16
    suifengdang666  
       2021-03-28 20:03:08 +08:00
    个人实名用户,去年 12 月开的全站加速 DCDN websocket 功能,全程自助开通,无需工单
    realpg
        17
    realpg  
       2021-03-28 20:33:45 +08:00
    @zlowly #13
    注册了就有手册就知足吧。。。
    有些国内项目,简介里啥都有,要看手册要注册,实名认证
    认证完了告诉你没这个功能
    flineqaq
        18
    flineqaq  
       2021-03-28 20:34:59 +08:00
    因为上行下效啊
    westoy
        19
    westoy  
       2021-03-28 20:36:45 +08:00
    厂家一开始就做, 后来慢慢做废掉的一般只有两种状况

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

    一种是真的没多少人用, 没必要浪费人力成本在这上面
    0ZXYDDu796nVCFxq
        20
    0ZXYDDu796nVCFxq  
       2021-03-28 20:44:24 +08:00 via Android
    2B 的基因问题吧
    看微软 Google oracle
    zhangshine
        21
    zhangshine  
       2021-03-28 21:48:02 +08:00   ❤️ 1
    成本高,程序员都 996 写 bug 了,那有时间写文档
    Lxxyx
        22
    Lxxyx  
       2021-03-28 22:03:29 +08:00
    因为国内的考核机制是要求出“花活”才能加薪晋升,而不是写文档这种“大家都会”,“没有价值”的事情(手动狗头)
    hotsymbol
        23
    hotsymbol  
       2021-03-28 22:07:11 +08:00
    不懂就问不是中华传统美德吗?
    R0n1n
        24
    R0n1n  
       2021-03-28 22:15:55 +08:00 via Android
    文档都弄好了,客服部门的 KPI 怎么办?
    opengps
        25
    opengps  
       2021-03-28 22:22:57 +08:00 via Android
    阿里云对于文档缺失,错误,等情景是有奖励的,登录聆听平台反馈,没事赚个单品类无门槛代金券之类的很爽
    Chingim
        26
    Chingim  
       2021-03-28 22:40:45 +08:00 via iPhone   ❤️ 2
    现在的情形是,写文档吃力不讨好,既占用自己的开发时间,又不被上级重视
    easylee
        27
    easylee  
       2021-03-28 22:41:57 +08:00
    就知道是 ali 系的,各种 404 和不介绍快疯了。
    sytnishizuiai
        28
    sytnishizuiai  
       2021-03-28 22:46:19 +08:00
    去年我用腾讯云短信,半天就申请短信模板,写代码和测试搞定了。
    上周我搞阿里云短信,php 文档多份不同的,研究了好久,才发现 17 年的才是最新的,要单独引入。模板不能申请金融的(那所有带交易的都咋办),短信情景还要我提供链接(好多业务都是下单操作后的),改了好久才通过。最后接入完了,发现没统计剩余短信的 api 。
    jadec0der
        29
    jadec0der  
       2021-03-29 07:23:39 +08:00   ❤️ 3
    写文档是一个很专业的事情,不是工程师写完代码顺便更新下文档。有兴趣可以去 linkedin 搜一下 aws technical writer 看一下 aws 有多少人负责写作,再点开几个人看看履历。

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

    没见过 technical writer 的工程师对文档的想象非常浅薄——就像煤老板对程序员的想象一样。
    touchwithe
        30
    touchwithe  
       2021-03-29 08:08:06 +08:00 via iPhone
    我司是阿里云企业大客户,售后一样是稀烂,文档万年不更新,甚至有误导内容。跟客服反馈过很多次,连错别字都没改。阿里云根本不重视这个,前端控制台也是一样垃圾。不说了,说起来就血压高。
    stardustree
        31
    stardustree  
       2021-03-29 08:41:57 +08:00
    企业不重视,经历过的几家公司,文档工程师离职率都很高,关心文档质量的产品经理也是凤毛麟角
    dvaknheo
        32
    dvaknheo  
       2021-03-29 08:49:05 +08:00
    @stardustree 文档不应该是产品的产出么?
    stardustree
        33
    stardustree  
       2021-03-29 10:43:16 +08:00
    @dvaknheo 专业的公司都有专门的文档工程师,实在没人才由产品兼职,产品还可以兼职项目经理、架构师和开发呢(●ˇ∀ˇ●)
    wangyzj
        34
    wangyzj  
       2021-03-29 11:19:50 +08:00
    跟你不写注释一个道理么不是
    Zzzz77
        35
    Zzzz77  
       2021-03-29 11:56:08 +08:00 via Android
    对于老板来说,写文档哪有写新功能来钱快
    lefer
        36
    lefer  
       2021-03-29 12:43:17 +08:00
    @killergun 查 Excel 的函数公式该如何使用,现在只去微软的 support 页面去查。页面内容翔实到连中文视频都有。。。
    lp10
        37
    lp10  
       2021-03-29 12:46:29 +08:00
    你是没见过美国某云服务自己 knowlegebase 各种 404 死链的。备份软件直接用的 restic,结果云服务在 restic 有自己的文档的情况下愣是把恢复操作的 source 和 destination 写反了……简直想骂人
    starkwang
        38
    starkwang  
       2021-03-29 13:55:51 +08:00
    文档这东西在老板眼中只是“用户体验问题”,不产出 KPI,即使你花了大量精力把产品文档完善了,也很难量化你的产出。相比之下,做一两个新功能新平台,靠嘴皮子谈下一两个大客户,那才叫“产出”。
    sansanhehe
        39
    sansanhehe  
       2021-03-29 14:09:38 +08:00
    泻药,人在外企,对文档的准确性要求很高,需求设计 QA 等文档都维护得很好
    AIFNI45Mdxn
        40
    AIFNI45Mdxn  
       2021-03-29 14:53:05 +08:00   ❤️ 1
    个人也可以申请开通的,只是要求比较高。我之前就开过的,不过确实需要工单审核的,我看了一下文档,不是有说明吗? https://help.aliyun.com/document_detail/145585.html:
    操作步骤:
    开通 Websocket 。
    目前 Websocket 功能需提交工单申请开通,并由阿里云售后专员进行审核,审核通过即可开通成功。开通成功且 Websocket 计费类型生效后,您才能正式使用 Websocket 功能。
    说明 开通 Websocket 功能之前,您需要先关闭 HTTP/2 设置功能,否则会造成服务异常。关闭方法,请参见配置 HTTP/2 。
    如果您是新用户,则 Websocket 计费立即生效。
    如果您是老用户,且全站加速的计费类型为按日计费,则生效时间为第二个自然日零点;如果您全站加速的计费类型为按月计费,则生效时间为次月 1 日零点。”
    SlipStupig
        41
    SlipStupig  
       2021-03-29 15:09:48 +08:00
    看过京东的文档,不看之前觉得能明白一些,看了之后完全不懂了
    echowuhao
        42
    echowuhao  
    OP
       2021-03-29 15:13:23 +08:00 via Android
    @AIFNI45Mdxn 恭喜你得到了它 我发帖之后改的
    cherryas
        43
    cherryas  
       2021-03-29 16:22:40 +08:00
    写文档无法计入 kpi 啊
    try4times
        44
    try4times  
       2021-03-29 16:30:48 +08:00
    有个职位叫文档开发工程师,国内甚少公司有
    huobazi
        45
    huobazi  
       2021-03-29 17:15:56 +08:00
    文档体现不出来 KPI 么
    abc1310054026
        46
    abc1310054026  
       2021-03-29 17:42:22 +08:00
    写好文档真不是个容易的活, 得有专职的人来写
    iplayio2019
        47
    iplayio2019  
       2021-03-29 20:06:28 +08:00 via Android
    @littlewing 不是所有的程序员都这样
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2541 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 28ms · UTC 15:08 · PVG 23:08 · LAX 07:08 · JFK 10:08
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.