2017 年 12 月发行说明

本月的发行说明包括新的内容版本、新迁移的内容、停用的内容、bug 修复和体验改进,以及性能改进!

新内容发布

迁移的内容

根据早期公告,我们会继续将内容从 MSDN 和 TechNet 迁移到 docs.microsoft.com。 下列仅为最近迁移的部分内容:

存档/停用/删除的内容

有些内容现已不受支持,但仍可供客户下载。

Bug 修复和体验改进

我们还在继续改进交互式教程体验,现在,在学习新技术或编程语言的过程中,需要担心的 bug 已经很少了。

交互

此外,还引入了对文章的版本控制,现在可以确保你所阅读的文档是目标产品的正确版本!

版本控制

docs.microsoft.com 的性能改进

虽然我们通常致力于开发 docs.microsoft.com 的新功能或 UX 增强功能,但我们的团队还坚定承诺不断改进基础知识,如辅助功能、全局就绪情况、安全性及性能。 在最新的网站更新中,我们发布了一些核心改进来呈现性能,在我们看来,与用户共享这些内容将相当有趣。 具体而言,我们全面改进了突出显示和呈现代码示例的方式。 自行了解呈现时间的差异:

代码块

在左侧,你会看到更新之前的呈现性能。 右侧则为改进后的体验。

我们是如何做到的?

第一步是确保仅突出显示代码并呈现你实际看到的示例的标头。 因此,如果已选择 C# 作为语言,则无需突出显示未查看的 C++ 示例。 这是相对比较直接的方式,而且内存、呈现时间和 DOM 中的 HTML 元素数目会稳定减少。

但是,我们认为可以对此进行进一步改进。 从处理的角度看,可以将指令解析和 HTML 构造转移到后台辅助线程。 然后就可以使用数据 URI 来加载语法突出显示辅助线程,进而使冷缓存方案中的往返行程减少。

同时,根据使用的浏览器,我们看到呈现时间最高减少了 88%,内存使用率最高减少了 90%,DOM 元素计数最高减少了 66%。 如果页面上有许多代码示例,这些性能更改将极大地影响移动设备方案或桌面方案(以 System.String 为例)。

反馈

希望你对在本文中了解到的有关我们对网站基础知识所展开的工作能够感到满意。 如果你对 docs.microsoft.com 的内容或体验有任何想法、想法或意见,或通过 Twitter 告知我们。