整整 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
评论