阿里云宣布文档开源,终于可以秀一波技术了

1,321 阅读13分钟
原文链接: click.aliyun.com
2

 饭娱咖啡 已获得开源文档T桖

1. 您经常使用阿里云文档吗?对文档有何建议?
经常使用啊!因为也是刚入门不久,什么都不懂!
我对文档的建议已经提交过“聆听”了。就是查看的时候不方便,目录页不好操作。貌似建议已经被采纳,现在应该在实现阶段吧。

2. 您怎么看待阿里云文档开源?
目前来说,阿里云的文档应该相当全面了,需要的文档信息都找到。但是,有些地方专业术性太强,理解起来会比较困难。
而文档开源则有助于让其他的开发者对文档出现问题进行补充和修正,可以让文档更丰富、让开发者更容易上手。
同时也能让更多人参与到阿里云的大家庭进来。相信不远的将来,阿里云文档会越来越完善,越来越好。

3. 您会参与文档开源,并成为官方内容贡献者吗?
我已经提交申请了。希望能尽自己的绵薄之力帮助更多的人。

发布时间:3天前 2人评论
1

 海阔天空yy 已获得开源文档T桖

1. 您经常使用阿里云文档吗?对文档有何建议?
使用过,但也不是很经常。文档一般有以下同个问题:
1 更新问题,即产品更新了,但文档还没更新,导至文档和产品形成脱节
2 从零开使指导用户,从一个demo起,从简单到深入,是容易被接受的
3 从一个入口进主文档,如果需要关联到其它文档,最好有连接,要不然靠自己再百度一遍,确实是一种时间和资源的浪费。
2. 您怎么看待阿里云文档开源?
我觉得这是一个大好事,文档可能对于开发该产品的人来说,没那么重要,毕竟我产品都做出来了,功能我啥都熟,写文档又不是我看,所以有时候并不会有多尽心,
但开源就不一样了,作为产品的用户来说,他们往往是最直接的使用者,文档应该怎么样他们才最清楚,所以由他们参与维护也是最好的.

3. 您会参与文档开源,并成为官方内容贡献者吗?
应该会的,这也是一个互相学习的过程,其实很多软件到了中国后其文档往往都比较弱,大多人还要去啃英文文档。国内这方面确实需要大家共同努力,补齐这块空白

发布时间:3天前 2人评论
1

 青藤木子

  1. 您经常使用阿里云文档吗?对文档有何建议?
    不经常使用,甚至我之前看阿里云文档感觉是在看阿里云的产品介绍和使用😂,对于我来说,阿里云可不可以加入一个技术开源文档?否则,开源在我们下一代眼中只是一堆说明,就连代码都没见到一点,很难体现开源的优势或者扭曲我们对开源的看法。
  2. 您怎么看待阿里云文档开源?
    阿里云文档开源可以利用了开源的优势,有利于产品使用和定制人性化,但我也怕对商业有一定的影响,能否把产品商业化和大众化区分开来对于我来说是很重要的事,大众化可以针对大众进行设置,商业化可以针对商业进行设置,就像阿里云官网专门为政府留通道一样。所以我希望可以制定一个商业的开源文档和大众的开源文档。
  3. 您会参与文档开源,并成为官方内容贡献者吗?
    会的,毕竟我也是开源爱好者,喜欢开源,并且开源无解释
发布时间:2天前 2人评论
3

 阿里云服务

补充下,如何参与文档开源
阿里云对外发布的文档以MarkDown格式开源在GitHub上。

  1. 单击目标文档页面右上角的编辑按钮,打开GitHub上对应文档。
  2. 在GitHub页面,单击 进入编辑状态。注:您需要登录GitHub账号后才能编辑和提交内容。
  3. 在编辑框中修改文档内容,编辑过程中可随时在预览框中进行内容预览。
  4. 提交修改内容并视需要补充修改意见。

阿里云会根据内容开源规定审核和处理您所提交的修改建议。提交的内容被阿里云采纳后,作为该篇内容的编辑者之一,您的GitHub头像会展现在该文档页面。

发布时间:3天前 0人评论
2

 巴洛克上校

1. 您经常使用阿里云文档吗?对文档有何建议?
经常使用啊,很多问题文档都会有答案,其实很多人在问答和论坛上提出的问题答案都在文档中找到答案,我也经常重文档复制这些内容来解决他们的问题,这期间我也发现了一些问题,提交的了聆听,其中一些是文档未更新,一部分有错误信息,还有功能性问题。这也说明了一个问题就是一部分人对文档还是不太知道,是否考虑可以自动识别问答问题向其推荐相关的文档,在没有解决办法在提交问题呢。

2. 您怎么看待阿里云文档开源?
当然好了,类似百度百科的做法不但可以更加丰富文档的内容,也能减少工作量,毕竟人多力量大,三人行必有我师,茫茫人海有很多大牛的存在,也只有用户最了解用户。

3. 您会参与文档开源,并成为官方内容贡献者吗?
如果时间允许会的,乐于助人是我的爱好,也能提高自己的技能和影响力。

发布时间:3天前 0人评论
1

 黄一刀

  1. 您经常使用阿里云文档吗?对文档有何建议?
    首先,我经常通过阅读阿里云产品文档,来寻找问题的解决方法,但通常,到最后,还是无法找到问题的正确解开方式,就算按着文档,一步步规规矩矩往下操作,到头来还是一阵白忙活,浪费了一个上午或者一个下午的时间,甚至一天的宝贵时间,穷途末路了,只能提交工单寻求帮助。但常常得到的回复是,现阶段还不支持该功能,我哭。我对阿里云产品文档的几点建议:(1)开源,用户可参与产品文档编辑;2、加入经验分享功能;3、加入用户评论功能;
  2. 您怎么看待阿里云文档开源?
    阿里云文档开源是代码开源精神的继承,其作用能更好地获得用户意见反馈和增进用户互动,帮助其他用户解决实际操作问题,促进和推动产品的改进和发展。我整整用了五年多的阿里云产品,通过不断的工单提交、意见建议、甚至一键投诉,目睹了阿里云产品点点滴滴的进度。
  3. 您会参与文档开源,并成为官方内容贡献者吗?
    这是肯定的,不仅要参与完善,还要参与吐槽,不断地促进阿里云产品的完善和创新,虽然五年多来,阿里云一直没给我这个老客户什么额外的优惠和特殊的待遇,但是我还是希望阿里云能做大做强,云产品能做得比甲骨文和亚马逊出色,毕竟这些年,阿里巴巴对中国IT行业技术发展所做的贡献是有目共睹的。
  4. 个人吐槽
    能不能什么产品动不动就商业化,小企业伤不起。
发布时间:40分钟前 0人评论
0

 1073624711990014

支持阿里云,现在正在用,很不错,稳定

发布时间:2天前 1人评论
0

 二令木三

开源地址在哪里?

发布时间:3天前 1人评论
0

 zijiejiang

1. 您经常使用阿里云文档吗?对文档有何建议?
我是经常查阅阿里云文档,尤其是接触一个新产品的时候。为了尽快熟悉新产品,我都是把文档下载PDF,或者直接打印出来没事的时候翻阅。999875775

阿里云的文档更新速度快,示例充分,解释简洁有效。谈到建议,还是有小小的一条,点击链接的时候能不能新建一个页面?(target=_blank)每次点击后退键有点麻烦。

另外,能不能在文档上让用户发表一些评论?评论区应该能成为用户间相互交流和学习的重要阵地。(thinkphp文档评论区截图:)
__2018_06_11T02_48_01_909Z

2. 您怎么看待阿里云文档开源?
个人来讲,对阿里云的文档开源,双手赞成。并且还有官方团队兜底审核,文档质量一定不会有任何问题,而且会更贴近用户。得知文档开源后我很兴奋,想了解下怎么开源,开源到什么程度,今天早上了看了下,果然不错。不仅仅能编辑示例代码,还能编辑文档简介等。不过还有很多页面不能编辑,相信这应该是一个逐步放开的过程。

3. 您会参与文档开源,并成为官方内容贡献者吗?
是的,会积极参与其中,不过很多文档细节按照不同的思路可能会有不同的写法。比如OSS SDK文档列出存储空间中的文件示例函数
function istAllObjects($ossClient, $bucket)
按照我的习惯可能是更侧重应用,如果我来写的话,应该是这样:
function listObjects($ossClient, $bucket,$dirName)

发布时间:30分钟前 0人评论
0

 1067428693174955

开源如何确保专利

发布时间:3小时前 0人评论
0

 浮生递归

  1. 您经常使用阿里云文档吗?对文档有何建议?
    经常,碰到问题的时候,第一个想到的就是阿里云文档。等待工单回复时,也是在那里不停的翻文档。感觉文档下面还有留言评论功能,真的非常赞。有些文档里没提到的,会在评论里出现。不过,其实这里也是一个切入点。既然有人留言询问,说明该问题文档里未描述清楚,所以对于评论里重复率比较高的问题,可以补充到文档里去,这样就不要再评论区里留言了。
  2. 您怎么看待阿里云文档开源?
    众人拾柴火焰高。虽然阿里云已经出了很大的力来构建阿里云文档,但是就跟社区文化一样,如果有广大群众参与的话,不管是数量还是质量,都能再上一个台阶。不过这是一种比较新的体系,如何对开源文档进行管理,又是一个新的问题,尚需阿里云来解决。
  3. 您会参与文档开源,并成为官方内容贡献者吗?
    会吧,自己碰到的问题,在文档里查不到,说明文档需要补充。而如果自己最终解决了这个问题,那么就可以把相关的明细写入开源文档,便于后人查阅,少走弯路。对自己也是一种沉淀。有时候一个问题,会重复碰到,自己又忘了当初是怎么解决的,结果又要重新摸索一遍,实在很坑。参与文档开源,利人利己。
发布时间:3小时前 0人评论
0

 麦老师

  1. 您经常使用阿里云文档吗?对文档有何建议?
    新产品使用的时候可能会去查看相关文档,有些文档写的并不是很全,安装相关依赖写的不是很全面,如果是小白的话,可能一个依赖环境就要纠结好久,再一个有些文档的更新并不是和产品完全同步的,这点可能需要多注意下,产品更新了,文档也实时跟进。

对于小白同学来说,越简单越好,最好可以有个演示,在线模拟环境。

  1. 您怎么看待阿里云文档开源?
    希望文档开源不只是个噱头,时间一长就没有开始的那股劲了,更多的人参与才能让文档做的更好
  2. 您会参与文档开源,并成为官方内容贡献者吗?
    人人为我,我为人人,如果时间充裕会考虑。
发布时间:4小时前 0人评论
0

 aly_o

文档很好, 有很多感兴趣的技术, 可以开拓知识点, 继续学习。

发布时间:4小时前 0人评论
0

 1973428688357284

目前还很迷茫,很多还搞不懂是怎么回事,希望简洁易懂

发布时间:4小时前 0人评论
0

 古散

  1. 您经常使用阿里云文档吗?对文档有何建议?
    经常,文档的更新维护可以更多的借助开发者的力量,同时增加一些应用案例的推荐
  2. 您怎么看待阿里云文档开源?
    开源可以让更多的人参与进来,促使文档保持一个极佳的阅览体验,并且更为准确和精准,是一件互利共赢的好事。
  3. 您会参与文档开源,并成为官方内容贡献者吗?
    目前在维护着其它开源项目,日常使用文档当中如有发现问题一定第一时间编辑修正。

如果有礼品希望有梓鸢小姐姐的签名,如果可以的话

发布时间:7小时前 0人评论
0

 骐源

1、您经常使用阿里云文档吗?对文档有何建议?
是的,有看文档的习惯,学习新东西的时候都经常看文档,近一段在学习阿里云的产品,经常看文档。
文档多是针对单一产品的,少有产品综合使用的。举例来说,像ecs、rds、slb、oss、ess经常需要交织配合使用,自己简单的学习试验而已,都会遇到许多的问题。

2、您怎么看待阿里云文档开源?
薪终会尽,火却会流传下去,对了,就是薪火相传。

3、您会参与文档开源,并成为官方内容贡献者吗?
是的,我想会的。

发布时间:7小时前 0人评论
0

 1643228639439229

安全好用

发布时间:15小时前 0人评论
0

 zw2002

文档很重要,但公司很少人去写。

发布时间:17小时前 0人评论
0

 hamlin

超爱阿里技术。很多感兴趣的技术,还有开源文档,慢慢研究。

发布时间:18小时前 0人评论
0

 1855426435994391

学习一下

发布时间:19小时前 0人评论 上一页 1 2 3 下一页 共3页