BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

MSDN/TechNet以docs.microsoft.com的全新形式开源发布

| 作者 Jonathan Allen 关注 594 他的粉丝 ,译者 邵思华 关注 3 他的粉丝 发布于 2016年5月9日. 估计阅读时间: 3 分钟 | QCon上海2018 关注大数据平台技术选型、搭建、系统迁移和优化的经验。

整整15年来,MSDN与TechNet的代码库几乎都没有经历过任何变化。近日,微软终于决定淘汰这两个网站,新的网站docs.microsoft.com将取而代之,并作为开源项目发布。Jeff Sandquist这样写道

简而言之,内容是非常重要的。这些年以来,我们在UserVoice平台上对于几百名开发者与IT专家进行了访问与问卷调查,并对网站中的各种反馈信息进行了筛选。很显然,我们是时候做出改变,为我们的内容创建一个现代化的web体验了。我们所做的第一件事是对于现有的内容基础平台TechNet和MSDN进行了一次评估,这两个网站的代码库维持了10至15年,已经变得相当脆弱了。其发布与部署系统也相当古老,并且原本就没有设计为在云环境中运行。

我们所专注的改进不仅在于使用体验方面,同时也体现在我们所创建的内容,以及用户使用它的方式。这些年来,客户一直在催促我们不要再提供那些大块的文本,而是以特性级别的内容取而代之,并帮助他们实现解决其业务问题的方案。我们已经认识到,我们所提交的内容以及所打造的平台必须让客户能够方便地学习以及实施各种方案。

新的网站不仅解决了一些基本的可读性问题,比如列的宽度以及字体的选择,同时还为每篇文章加入了是时间戳以及预计阅读所需时间。时间戳的引入使MSDN与TechNet网站上一个持续已久的问题得到了缓解:往往当某人读完一整篇文章之后,才意识到该文章只对应某个早已过期的产品版本。预计阅读时间本身并不太重要,但微软将利用该数字对文章的长度进行一些调整,让他们显得不至于长太。

在docs.microsoft.com上的所有文档都已实现了开源。

微软之前曾经提供了一个“社区补充”特性,但对于该特性的支持很不规范。举例来说,面向.NET 3.5版本的ReaderWriterLockSlim类的介绍页面中出现的一些留言与.NET 4.0版本中同一个类的留言就有所不同。并且在“当前版本”页面中完全遗漏了留言功能。

因此,微软决定不再继续使用这个混乱的页面,新的页面将加入一个“编辑”按钮,读者可通过该按钮对markdown进行编辑,并直接提交一个pull request。事实上,你甚至可以下载保存了所有文档的整个git代码库

为了提供更多非官方的变更功能,新的网站已经“与Livefyre进行合作,为所有文章留言与旁注功能。”

内容预览与路线图

目前的预览版仅涵盖了“企业移动文档”。随着时间推移,有更多的内容将转移至新版的网站上,而旧版MSDN与TechNet的页面将会重定向至新的页面。

查看英文原文MSDN/TechNet Being Open Sourced as docs.microsoft.com

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT