docs.microsoft.com 简介
今天,我们宣布推出新的文档服务 https://docs.microsoft.com预览版,展示支持企业移动性产品的内容。
简言之,内容很重要。 我们采访并调查了数百名开发人员和 IT 专业人员,并筛选了多年来关于 UserVoice 网站反馈。 很明显,我们需要进行更改,并为内容创建新式 Web 体验。 我们做的第一件事是评估 TechNet 和 MSDN的现有内容基础结构。 这两个站点都构建在一个 10-15 岁的脆弱代码库上,其原型发布和部署系统从未设计为在云上运行。
我们的重点不仅在于体验,还关注我们创建的内容以及每个用户如何使用它。 多年来,客户告诉我们要超越具有功能级内容的文本墙,并帮助他们实现业务问题的解决方案。 我们知道,我们提供的内容和我们构建的平台必须使客户能够轻松学习和部署解决方案。
我们意识到,为了正确获得整体体验,我们需要从头开始;这一努力 https://docs.microsoft.com,这是Microsoft文档的新希望。
注意:此网站的预览版包含适用于企业移动性文档的内容*仅限*(其中包括 高级威胁分析、Azure Active Directory、Azure 远程应用、多重身份验证、Azure Rights Management、Intune和 Microsoft Identity Manager)。 将来,随着我们的平台在反馈的帮助下成熟,我们会将更多文档迁移到此体验。
让我们从下面显示的示例文档页面开始,我们将展示网站上的一些新功能。

为了提高内容可读性,我们更改了网站以设置内容宽度。 眼跟踪研究 表明,你可以通过设置的内容宽度提高理解和阅读速度,因为眼睛很难跟踪长段从左到右。 若要在操作中显示此操作,下面是在 docs.microsoft.com 上运行的 Intune 文章的示例,后跟 TechNet 上的同一篇文章。 我们还增加了左侧导航和文本的字号,客户一直在要求(UserVoice - 增加字号)。

我们基于你的输入进行的另一个简单的增强是提供文章的估计阅读时间。 我们知道你们中的许多人在会议之间学习/评估技术,如果你知道需要多少时间承诺,你更有可能阅读文章。 我们还向内容添加了日期戳,以帮助客户了解信息基于 UserVoice 反馈的新鲜程度。

基于客户访谈和 UserVoice 反馈 的一个关键投资领域是基于客户的意图对网站导航、信息体系结构和内容组织的改进。 我们将内容重构为逻辑分组,围绕评估、入门、规划、部署、管理或排查产品或服务问题。 可以在左侧导航和产品/服务页面中看到此内容细分。
下面是 Intune 文档 主页的屏幕截图:

此相同的分类也位于文章的左侧导航上:

另一个常见的反馈是,我们的内容有时可能是压倒性的,因为它的长度和较长的文章更难以导航和找到你要查找的内容。 为了解决此问题,我们已将较长的文章细分为较小的逻辑步骤,并在文章底部提供“上一步”和“下一步”按钮,以在多部分教程中的步骤之间导航,如下所示。
“后退”和“下一步”按钮虽然许多客户喜欢拥有多部分教程,但我们也听到客户希望将多步骤教程组合成单一脱机打印机友好 PDF 的客户。 我们还没有这个,但它即将推出预览版。
为了在移动设备、平板电脑和电脑上构建出色的体验,就像你在 UserVoice一样,我们切换到了响应式布局。 单击“选项”按钮将展开/折叠以显示桌面视图上的相同选项。

有关 docs.microsoft.com 的所有文档都是开源的,旨在允许社区参与。 随后,Microsoft的其他团队的脚步,这些团队已经开放了其文档的所有或部分,包括 ASP.NET、Azure、.NET Core,以及 Microsoft Graph。
每篇文章都有一个“编辑”按钮(如下所示),该按钮将转到 GitHub 中的源 Markdown 文件,你可以在其中轻松提交拉取请求来修复或改进内容。
你的问题、评论和反馈对我们很重要。 我们与 [Livefyre](https://web.livefyre.com/)
合作,提供有关所有文章的评论和旁注。 在每篇文章的顶部,你将看到一个评论链接,如下所示。

单击批注会将你带到页面底部,你可以在其中登录(使用 Twitter、Facebook、Google、Yahoo 或Microsoft凭据)添加、关注或喜欢批注。
在底部批注还可以在每段内容或特别突出显示的文本上添加旁注或备注。 为此,请将鼠标光标放在右侧的注释符号上,单击它以添加内联注释。


通过页面顶部的共享按钮,可以轻松地与 Twitter 和 Facebook 共享。

还可以使用鼠标光标从上下文菜单中选择文章中的内容,直接从上下文菜单中在 Twitter 或 Facebook 上添加批注或共享,如下所示。

我们关心我们的 Web 体验,一件事经常将我们误认为 TechNet 和 MSDN 的用户是文章没有友好、可读的 URL。 下面是包含新 URL 的同一篇文章的示例。
之前:
<https://technet.microsoft.com/library/dn646983.aspx>
之后:
<https://learn.microsoft.com/intune/get-started/start-with-a-paid-subscription-to-microsoft-intune>
我们还向文章添加了主题选取器,以便你可以在浅色和深色主题之间进行更改,其中一些人要求 UserVoice。

下图显示了浅色和深色主题之间的差异。

网站性能等基础知识是一项关键功能,许多客户要求我们改进 UserVoice。 docs.microsoft.com 上的页面加载时间在加载时间方面速度在 50-300% 之间,我们比以前更适合异地分布。 我们还基于在 Azure 上运行 100% 的体系结构构建。
我们希望你享受 docs.microsoft.com 预览版,请向我们发送反馈以 https://aka.ms/sitefeedback。 在未来的帖子中,我们将讨论我们的计划,以显著提高参考内容的体验和内容本地化计划。