
1 7654 2021-03-28 17:41:37 +08:00 这是套路吧,告诉你有,但是不告诉你怎么才能拥有,非要注册使用后才说限制条件 |
2 cubecube 2021-03-28 17:46:29 +08:00 @7654 并不完全是套路。完全就是规模和数量太多,很难保持一致导致的。阿里云这块还算做得比较好的。 很多产品开发和文档是两个部门在弄,工作节奏不一致,而且产品太多了,有时候内部都不清楚最新的版本是啥,都要拉群问的。 |
3 killergun 2021-03-28 17:47:35 +08:00 看看微软的文档 |
4 risky 2021-03-28 17:48:02 +08:00 感觉阿里云的文档稀碎,官方也有不少实习生 SDK,不是写得差的那种,是根本就有错误 |
5 echowuhao OP @cubecube 规模是一个因素,这个是个管理的问题,更新了 feature,然后更新文档。问了半天,他们也没少花时间,我也浪费了时间。 |
6 dream7758522 2021-03-28 18:04:23 +08:0 via Android 哈哈,腾讯小程序的文档 |
7 yigecaiji 2021-03-28 18:07:08 +08:00 via Android 想到每次用阿里的 docker 源的时候都要找很久。 |
8 kingfalse 2021-03-28 18:13:07 +08:00 via Android 阿里的文档各种 bug,官方的 demo 各种跑不通 |
9 AndyAO 2021-03-28 18:19:25 +08:00 微软的文档好像做得很不错,是开源的,可以提交 Pull Request,错误可能会少点吧。 |
10 littlewing 2021-03-28 18:22:14 +08:00 via iPhone 程序员最讨厌的两件事 1. 别人的项目没文档 2. 给自己的项目写文档 |
11 7654 2021-03-28 18:46:47 +08:00 @cubecube #2 @echowuhao #5 https://www.aliyun.com/price/product#/dcdn/detail 上面的是收费说明,全篇只有在预付费资源包一栏有强调实名认证用户可购买资源包 |
12 seakingii 2021-03-28 18:48:16 +08:00 国内厂商普遍不重视文档。 |
13 zlowly 2021-03-28 19:01:43 +08:00 没错,国内厂商不重视文档是普遍现象。用过几个国内大厂的出品,那文档滞后不谈,而且内容简陋,歧义甚,不注册官网就基本没在线手册,手册版本不全,API 、程序范例出错漏更不鲜见。 不要说程序员最讨厌写文档,对比一下国外随便一个成熟产品都比它们做得好,他们的程序员就不是程序员了? |
14 hoyixi 2021-03-28 19:09:03 +08:00 限制条件一开始就说,怎么吸引脑袋热的下订单 |
16 bpf2049 2021-03-28 20:03:08 +08:00 个人实名用户,去年 12 月开的全站加速 DCDN websocket 功能,全程自助开通,无需工单 |
17 realpg PRO |
18 flineqaq 2021-03-28 20:34:59 +08:00 因为上行下效啊 |
19 westoy 2021-03-28 20:36:45 +08:00 厂家一开始就做, 后来慢慢做废掉的一般只有两种状况 厂家不希望小客户用, 人为制造学习和沟通障碍 一种是真的没多少人用, 没必要浪费人力成本在这上面 |
20 0ZXYDDu796nVCFxq 2021-03-28 20:44:24 +08:00 via Android 2B 的基因问题吧 看微软 Google oracle |
21 zhangshine 2021-03-28 21:48:02 +08:00 成本高,程序员都 996 写 bug 了,那有时间写文档 |
22 Lxxyx 2021-03-28 22:03:29 +08:00 因为国内的考核机制是要求出“花活”才能加薪晋升,而不是写文档这种“大家都会”,“没有价值”的事情(手动狗头) |
23 hotsymbol 2021-03-28 22:07:11 +08:00 不懂就问不是中华传统美德吗? |
24 R0n1n 2021-03-28 22:15:55 +08:00 via Android 文档都弄好了,客服部门的 KPI 怎么办? |
25 opengps 2021-03-28 22:22:57 +08:00 via Android 阿里云对于文档缺失,错误,等情景是有奖励的,登录聆听平台反馈,没事赚个单品类无门槛代金券之类的很爽 |
26 Chingim 2021-03-28 22:40:45 +08:00 via iPhone 现在的情形是,写文档吃力不讨好,既占用自己的开发时间,又不被上级重视 |
27 easylee 2021-03-28 22:41:57 +08:00 就知道是 ali 系的,各种 404 和不介绍快疯了。 |
28 sytnishizuiai 2021-03-28 22:46:19 +08:00 去年我用腾讯云短信,半天就申请短信模板,写代码和测试搞定了。 上周我搞阿里云短信,php 文档多份不同的,研究了好久,才发现 17 年的才是最新的,要单独引入。模板不能申请金融的(那所有带交易的都咋办),短信情景还要我提供链接(好多业务都是下单操作后的),改了好久才通过。最后接入完了,发现没统计剩短信的 api 。 |
29 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 的工程师对文档的想象非常浅薄就像煤老板对程序员的想象一样。 |
30 touchwithe 2021-03-29 08:08:06 +08:00 via iPhone 我司是阿里云企业大客户,售后一样是稀烂,文档万年不更新,甚至有误导内容。跟客服反馈过很多次,连错别字都没改。阿里云根本不重视这个,前端控制台也是一样垃圾。不说了,说起来就血压高。 |
31 stardustree 2021-03-29 08:41:57 +08:00 企业不重视,经历过的几家公司,文档工程师离职率都很高,关心文档质量的产品经理也是凤毛麟角 |
32 dvaknheo 2021-03-29 08:49:05 +08:00 @stardustree 文档不应该是产品的产出么? |
33 stardustree 2021-03-29 10:43:16 +08:00 @dvaknheo 专业的公司都有专门的文档工程师,实在没人才由产品兼职,产品还可以兼职项目经理、架构师和开发呢(●ˇˇ●) |
34 wangyzj 2021-03-29 11:19:50 +08:00 跟你不写注释一个道理么不是 |
35 Zzzz77 2021-03-29 11:56:08 +08:00 via Android 对于老板来说,写文档哪有写新功能来钱快 |
36 lefer 2021-03-29 12:43:17 +08:00 @killergun 查 Excel 的函数公式该如何使用,现在只去微软的 support 页面去查。页面内容翔实到连中文视频都有。。。 |
37 lp10 2021-03-29 12:46:29 +08:00 你是没见过美国某云服务自己 knowlegebase 各种 404 死链的。备份软件直接用的 restic,结果云服务在 restic 有自己的文档的情况下愣是把恢复操作的 source 和 destination 写反了……简直想骂人 |
38 starkwang 2021-03-29 13:55:51 +08:00 文档这东西在老板眼中只是“用户体验问题”,不产出 KPI,即使你花了大量精力把产品文档完善了,也很难量化你的产出。相比之下,做一两个新功能新平台,靠嘴皮子谈下一两个大客户,那才叫“产出”。 |
39 sansanhehe 2021-03-29 14:09:38 +08:00 泻药,人在外企,对文档的准确性要求很高,需求设计 QA 等文档都维护得很好 |
40 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 日零点。” |
41 SlipStupig 2021-03-29 15:09:48 +08:00 看过京东的文档,不看之前觉得能明白一些,看了之后完全不懂了 |
42 echowuhao OP @AIFNI45Mdxn 恭喜你得到了它 我发帖之后改的 |
43 cherryas 2021-03-29 16:22:40 +08:00 写文档无法计入 kpi 啊 |
44 try4times 2021-03-29 16:30:48 +08:00 有个职位叫文档开发工程师,国内甚少公司有 |
45 huobazi 2021-03-29 17:15:56 +08:00 文档体现不出来 KPI 么 |
46 abc1310054026 2021-03-29 17:42:22 +08:00 写好文档真不是个容易的活, 得有专职的人来写 |
47 iplayio2019 2021-03-29 20:06:28 +08:00 via Android @littlewing 不是所有的程序员都这样 |