1. 聚能聊>
  2. 话题详情

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

文档开源的前世今生

开源项目一直是很多开发者的宠儿。通过开源,开发者集思广益,共同管理、分享、学习某个产品及其代码,通过精英式的管理方式,诞生了很多款优秀的开源软件,长期以来在软件市场占据这独特的地位。

但是对于IT行业,产品文档开源还是新鲜事物。不管是在传统的通信行业,还是在飞速发展的互联网行业,文档历来是产品的重要组成部分,是产品拼图中不可或缺的那一块。甚至毫不夸张的说,某种意义上,文档承载着产品的颜值担当,体现着公司的整体实力。越是大厂商,对文档越重视。用户依赖文档了解产品的应用场景、功能特性、使用方法、排查问题,其使用之频繁,体验之重要,但凡使用过文档的用户都会有切身体会。

但长久以来,产品文档一般都是从企业到用户单向流动。用户只能被动的阅读文档内容,而对文档内容的开发和管理,则无缘参与,甚至反馈意见的方式和流程也不够顺畅,导致产品文档和用户之间无法形成良性互动。用户苦于无处反馈、产品团队苦于听不到用户声音,互相隔膜。同时,企业出于信息安全、管理成本等各方面考虑,也往往不敢、不愿让用户直接参与文档内容的开发。像Wiki那种协同编辑文档的模式,在商业化软件中是很难想象的。

阿里云文档开源来了!

但在神奇的互联网领域,一切皆有可能。阿里云重磅宣布,6月7开始对阿里云文档进行开源!这一重大举措,体现了阿里云作为业界领导者海纳百川的恢弘气度、高瞻远瞩的开阔格局、和用户至上的勇敢担当。

posts_img_138001_15283430989267_jpg_620x10000

文档开源的价值

阿里云文档开源之后,会对文档内容的管理、开发、发布、体验等全方位带来深远的影响和价值,例如:

实现多方合作。引入众包力量,从开发、测试、架构、技术、用户体验等多视角,不断完善和补充文档内容,持续丰富文档,打造日趋完善的文档库。

用户深度参与。用户能够更容易的对产品和文档进行反馈、提出建议,全程深度参与产品和文档的开发流程,甚至主动贡献有价值的内容,把实践经验沉淀到文档,分享给更多的用户使用。引导用户使用文档、重视文档、参与文档、共同提升文档水平。

打造业界标杆。作为文档开源的首批先行者,阿里云文档将成为国内、乃至整个行业内的标杆,从而进一步提升阿里云文档乃至产品的影响力。

实现生态发展。通过文档开源,逐步形成阿里云的生态化发展,形成完整的内容生产生态链的管理与运营。

文档开源计划

阿里云开源项目计划分以下三步走:

1

文档开源的交互模式

随着文档开源不断发展,我们将逐渐推出众包及用户与阿里云文档的两种全新交互模式:

模式1 平台分发:文档平台分发任务生态合作伙伴上线领取任务。这是从产品自上而下的流程。文档平台首先分发任务给生态伙伴,生态伙伴线上领取任务之后开始开发相关文档,完成后提交到平台进行评审、审核、发布。

模式2 用户触发:用户主动更新现有内容提交内容内容审核后被采用领取相应奖励与头衔。这是从用户自下而上的流程。用户发现问题,或者有更新文档的想法,可以主动提交内容,经过审核流程后,会发布到线上的文档中心。发布成功后,用户可以领取相应的奖励和头衔。这种模式通过用户的深度参与。

展望

文档开源是阿里云迈出的重要一步。我们期待,通过文档开源,阿里云开启与用户线上良性互动、亲密合作的新时代!

欢迎大家互动:

1. 您经常使用阿里云文档吗?对文档有何建议?

2. 您怎么看待阿里云文档开源?

3. 您会参与文档开源,并成为官方内容贡献者吗?

参与话题

奖品区域 活动规则 已 结束

  • 奖品一

    开源文档T桖 x 5

  • 奖品二

    开源文档纪念公仔 x 4

79个回答

2

饭娱咖啡 已获得开源文档T桖 复制链接去分享

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

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

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

饭娱咖啡 回复

我想要T恤!(^▽^)

阿里云服务 回复

感激您的支持!欢迎您提供更多建议~~~

青藤木子 回复

开心!我可以要一件衣服吗?!

1455049280927080 回复

我也想要T恤

liuliqun 回复

T恤,给一打吧!

itstimmy 回复

我是新手,教我如何操作

评论
2

青藤木子 已获得开源文档T桖 复制链接去分享

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

补充一点:商业模式很重要

阿里云服务 回复

收到您宝贵的建议,我们将持续为文档使用者提供最佳体验,加油!

monsterv4 回复

很有想法

monsterv4 回复

开心!可以得一件T恤吗

评论
5

黄一刀 已获得开源文档T桖 复制链接去分享

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

海阔天空yy 已获得开源文档T桖 复制链接去分享

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

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

柯炎 回复

“从零开使指导用户,从一个demo起,从简单到深入,是容易被接受的。” 这种形式是否能满足您的需求:https://help.aliyun.com/document_detail/66934.html

评论
1

故事老神仙 已获得开源文档纪念公仔 复制链接去分享

  1. 您经常使用阿里云文档吗?对文档有何建议?
    之前有了解过,然后日前去体验了一把。然后有几点建议如下:¹.一个整体的简介不能忽视,这会决定用户的学习程度,².文档里可以多一些屏幕截图,一图胜过千言,截图可以帮助我们去了解产品,³.然后就是多一些新手的东西,因为并不是所有的人都对产品很了解,所以一些基础的东西也是需要在文档中体现出来的,这样有助于用户快速的了解。
  2. 您怎么看待阿里云文档开源?
    文档开源对于我们这些使用者来说,当然是好事啊,我也使用或者了解过不少的开源项目,但是大部分只有代码和少量注释,却很少有完整的文档的,这就导致这些开源的源码被使用的范围不广泛,只呢是少部分人的玩具,因为没有开源文档就需要使用者投入大量的人力和时间去研究代码,像我们个人的话去使用就更不用说了。这是开源了,但只是开源一部分,很难体现开源真正的优势。而阿里云的文档开源,无疑给了我们很多的方便,更容易的去使用产品。
  3. 您会参与文档开源,并成为官方内容贡献者吗?
    愿意啊,贡献内容帮助他人,也是在帮助我自己啊,美美与共,天下大同。最常说的例子就是你有一个苹果我有一个苹果,交换一下,还是一个苹果,但是你有一个想法我有一个想法,那么交换一下,就有两个想法。

给打赏件T恤好吗?哈哈哈哈我脸皮厚。

故事老神仙 回复

想要T恤~(≧▽≦)/~,照片上的小姐姐挺好看的哈哈哈哈

故事老神仙 回复

想要T恤~(≧▽≦)/~,照片上的小姐姐挺好看的哈哈哈哈

评论
0

kevinflash 已获得开源文档纪念公仔 复制链接去分享

  1. 您经常使用阿里云文档吗?对文档有何建议?
    答:经常使用文档。阿里的文档是每次跟朋友聊开源聊新技术学习的时候都会提到的。作为国内大厂之一,这点很让人骄傲,因为毕竟有的时候很多产品再好,点开了甚至只是API说明都只是了了数语不谈参数。

最关键的是阿里云文档的分类很让人称叹,我不知道是所有coder还是仅仅是部分人,m对于文档文件的分类有着极致的要求。并不是说没有一个很好的分类就找不到了,只能说有一个很好的分类会让人很舒服,而且也会让人觉得很专业。
说到这点,除此之外,阿里接口文档还有demo也很让人喜欢,不论从本身代码规范来说,还是注释都很让人简单易懂。

  1. 您怎么看待阿里云文档开源?
    答:非常好啊!很期待阿里云文档,可以跟世界接轨,让各地的coder加入到大家庭中。也很期待自己会见到一个怎样不同的阿里云未来。
  2. 您会参与文档开源,并成为官方内容贡献者吗?
    答:Absolutely !!!!一直在期待,也一直在为了开源社区做一些细微的帮助,只可惜作为底层coder时间真的不是特别多。但凡是有时间有机会,我都会静下心去将自己工作中还有学习中得到的笔记整理出来贡献给大家。

最后,希望阿里云越来越好,云栖社区越来越国际化,也更希望生态可以越来越好,最后希望自己有朝一日可以为世界的数字世界做出一点贡献。

鹤壁花卉 回复

不错

评论
1

李沃晟 已获得开源文档纪念公仔 复制链接去分享

1. 您经常使用阿里云文档吗?对文档有何建议?
碰到相关产品的问题首先就是搜索文档咯,但是有些时候是找不到内容的,这时候如果可以自己把自己的解决过程po上去那大家再碰到相同的问题就可以解决了~
2. 您怎么看待阿里云文档开源?
跟普洱一样,越陈越有味道,未来会有越来越多的贡献者参与进来~
3. 您会参与文档开源,并成为官方内容贡献者吗?
非常乐意,IT人最重要的就是分享精神啊~

1

巴洛克上校 已获得开源文档T桖 复制链接去分享

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

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

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

0

云栖小社 已获得开源文档纪念公仔 复制链接去分享

  1. 您经常使用阿里云文档吗?对文档有何建议?
    本人几乎天天都会看文档并且把文档作为日常工作的标准,因为本身是做linux运维,所以长期对于技术文档的依赖非常大,即使经过二三次左右的实践在正式配置前还是有可能过一眼技术文档。对文档的建议本人也曾经多次参与,把一些提出的建议或更正在没有文档开源前是通过聆听平台发出建议,也被阿里云奖励过代金券等。建议阿里云把文档继续坚持丰富下去,整合全网技术社区论坛的文档,做到一个真正的编程和运维人员离不开的平台。
  2. 您怎么看待阿里云文档开源?
    阿里云文档开源对于我们长期从事运维的人员是一个福利,我们不但可以通过多种方式分享和学习阿里珍藏的技术文档还可以自主发起更改建议,更加有利于技术的更新和完善。
  3. 您会参与文档开源,并成为官方内容贡献者吗?
    我已经在参与文档开源的道路上了,并且会继续坚持下去,和所有在阿里云平台的研发和运维人员共同学习进步,十分愿意成为官方的内容贡献者!
云栖小社 回复

我要公仔啦,谢谢

评论
4

阿里云服务 复制链接去分享

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

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

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

巴洛克上校 回复

我想要T恤!(^▽^)

评论
0

1073624711990014 复制链接去分享

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

水木天狼 回复

支持,从群众中来到群众中去

评论
0

二令木三 复制链接去分享

开源地址在哪里?

小易1246 回复

阿里云文档开源地址:https://github.com/AlibabaCloudDocs/
已经开源的文档中页面右上角都有编辑入口哦,直接点击就可以跳转到编辑页了。操作指南了解下:https://help.aliyun.com/document_detail/73667.html

评论
0

moon_tao 复制链接去分享

  1. 您经常使用阿里云文档吗?对文档有何建议?
    经常使用啊!因为也是刚入门不久,什么都不懂!

个人喜欢看阿里云的帮助文档以及相关的知识分享,因为入行不久,很喜欢这种形式,当获得成长,我也会将此接力棒传下去。

  1. 您怎么看待阿里云文档开源?
    目前来说,阿里云文档开源好处在于可以学习良好经验,同时也能让更多人参与到阿里云的大家庭进来。
  2. 您会参与文档开源,并成为官方内容贡献者吗?
    希望能尽自己的绵薄之力将开源精神传递下去帮助更多的人。
0

太阳树123 复制链接去分享

开放文档代表了自信、包容和合作,向阿里致敬、学习!

0

一根白发 复制链接去分享

  1. 您经常使用阿里云文档吗?对文档有何建议?
    会的,我虽然是个业余程序员,但只要是有不明白的地方就会上阿里云找解答,阿里云文档很齐全,查找方便快捷,因为业余所以热爱,没啥好的建议,希望阿里云文档里面的资料越来越齐全吧,让更多的人发现这里,共同学习。
  2. 您怎么看待阿里云文档开源?
    阿里云文档来源好比安卓与iOS,开源的产品肯定是会让更多的人接触,不断精进,共同学习,未来社会发展需要这样。
  3. 您会参与文档开源,并成为官方内容贡献者吗?
    会的,2015年接触的阿里云,也是真正意义上接触互联网,一眼就爱上,2年了,现在所有互联网技术知识都是阿里上学来的,感谢阿里云让我们共同成长,期待有一天,商业不再沉稳,利他之花开遍大地,相信有一天,万家灯火照亮都市,人们投来赞许的目光,不是因为我们的成就,而是因为我同生共好,一同成长。
0

ohooho 复制链接去分享

什么样的文档适合开源?文档创造的价值如何符合众利的开源精神?

0

1731207260812979 复制链接去分享

文档开源惠及大家啊

0

jeyx 复制链接去分享

然后就是信息数据越来越大越来越多?

0

myqf2011 复制链接去分享

文档开源,实现共赢,发福利了

0

鹤壁花卉 复制链接去分享

很不错的

4
7891
浏览
0
收藏
邀请他人互动
关注
16
粉丝
725
话题
1

简介:

阿里云离客户最近的团队,带来阿里云服务一手资讯、经典案例、最佳实践。
为金融行业提供量身定制的云计算服务,具备低成本、高弹性、高可用、安全合规的特性。帮助金融客户实现从传统IT向云计...

充分利用阿里云现有资源管理和服务体系,引入中间件成熟的整套分布式计算框架,以应用为中心,帮助企业级客户轻松构建并...

超过10,000,000域名在这里注册

为您提供简单高效、处理能力可弹性伸缩的计算服务,帮助您快速构建更稳定、安全的应用,提升运维效率,降低 IT 成本...