关于 MSDN 和 TechNet 迁移到 docs.microsoft.com 的最新消息

  • 项目

本文由负责开发人员关系的企业副总裁 Jeff Sandquist 撰写。

今天，我们非常高兴地宣布一个重要更新 - MSDN 和 TechNet 的内容迁移到 docs.microsoft.com。 此博客文章记录了以下公司范围工作的最后一些步骤：修改内容结构、格式和底层基础结构并将 Microsoft 技术文档集中到同一个站点。

从 MSDN 和 TechNet 到 docs.microsoft.com

1992 年，Microsoft Developer Network 作为客户订阅服务推出，旨在提供 Windows 编程技术信息。 六年后的 1998 年，MSDN Online 网站启动，托管超过 250,000 个页面的内容。

MSDN Online 1999 年的屏幕截图

当时，发布过程包括在 Microsoft Word中创建内容，将其转换为 HTML，并通过名为pubwiz“ (发布向导”) 的工具进行发布。 20 多年来，这个过程支持了新产品、服务和更新的发布，生成了惊人的 4500 万个页面的技术内容！

随着产品发布周期从年变为月，对于可访问的最新文档的需求也在增长。 发布系统需要跟上工程速度，因此我们决定重新设计 Microsoft 在云时代管理文档的方法。 2015 年 11 月，docs.microsoft.com 团队的创始成员 Dan Fernandez、Mary McHale、Carol Zeumault 和 Jeff Sandquist 编写了名为“A New Hope”（致敬“星球大战 4”）的一篇文档，该文档概述了新站点的愿景。 该文档中包括了一系列关键指导原则：

  • 统一的技术文档。 新网站应合并 Microsoft 托管的几十个文档网站。 对于学习如何创建数据驱动的 Web 应用的开发人员，只需访问一个网站就可以找到 ASP.NET、Azure、实体框架或 Microsoft 其他任何技术的所有相关内容。
  • 改善的用户体验。 定义网站成功与否的关键因素之一是网站提供给客户的体验。 新网站应具有更好的加载性能、易读的字体、可访问的内容表、人类易读的 URL、对版本控制的支持和与移动浏览器的兼容性，并能通过可访问的功能和对国际化的支持来遵循包容型设计的做法。
  • 普及创作和社区参与。 新网站应由开放源代码标准和工具支持，以便所有人都能创建和编辑文档。 新网站应将 Markdown 用于内容，将 YAML 用于自动生成的 API 文档，并将 GitHub 作为基础内容层，以便使用自动化质量检查。 正如 The State of the Octoverse 2018 中所述，MicrosoftDocs GitHub 组织已拥有超过 7,400 个成员，Azure 文档存储库是增长最快的开放源代码项目之一（年同比增长 470%），也是整个 GitHub 中获得的贡献量第五大的存储库！
  • 支持 API 文档。 新网站应为 API 文档提供一流的支持，这些文档针对客户使用的编程语言和平台编写，包括 .NET、Java、Python、JavaScript 和 TypeScript、PowerShell、Azure CLI、Q#、OpenAPI 等。 该体验应由自动化支持，它具有可靠的 API 覆盖，能够在几分钟（而不是几周）之内发布 API 文档。
  • 工程基础结构现代化。 docs.microsoft.com 应在 Azure 上运行，从而减少维护费用（节省超过 700 万美元），将部署次数从每三周一次提高到每天一次（或更快），并减少了工程重复。
  • 默认可扩展。 随着网站不断发展，它必须要以最有效的方式满足客户的需求。 基于这个承诺，我们得以构建并集成全新的交互式学习体验 Microsoft Learn 以及示例代码浏览器。

随着新式平台就位，我们将开始确保不会在迁移到新网站的过程中丢失有价值的内容。 以下是有关我们的进展的更多信息。

MSDN 和 TechNet 库

状态：✅ 完成

我们从 2017 年年底开始将 MSDN 库和 TechNet 库迁移到 docs.microsoft.com，并于今年完成了该迁移。

这些库以前为 Microsoft 产品提供文档，包括 API 文档、示例代码和技术文章。 最初，内容通过 CD 提供，后来随着 MSDN 和 TechNet 网站的推出，内容变成在线提供。

迁移需要将多种基于 XML 的格式转换为 Markdown（对于人类编辑内容）和 YAML（对于自动生成的 API 文档），涉及一百多个不同的内容集。 我们已确保针对数百万网页的页面重定向准备就绪，防止引用我们网站外的已损坏链接，例如博客和论坛。

通过以下数据，你可以大致了解我们处理的内容量：

如果你已为任何 MSDN 或 TechNet 内容添加书签，链接将无缝重定向到它们在 docs.microsoft.com 上的新位置。

MSDN 杂志

状态：✅ 完成

MSDN 杂志的最后一期发布于 2019年 11 月 1 日。 在 MSDN 杂志的八月版中，我们已向读者和作者发送了最终消息。

已在 MSDN 上发布的 MSDN 杂志内容已移至 docs.microsoft.com/archive。

已支付订阅费用的 MSDN 杂志订阅者将收到一笔按比例的退款，退款金额取决于其订阅的剩余时间。 退款支票将在杂志 11 月期发布后寄出。 此更改不会影响 MSDN 平台订阅。

Microsoft 开发人员和 TechNet 快讯

状态：✅ 完成

已在 MSDN 和 TechNet 上发布的新闻稿已移动到 docs.microsoft.com/archive。

当前订阅者会继续收到这些新闻稿。 我们可能会更改格式和发布计划。

如果你不想再订阅我们的新闻稿，可以通过收到的下一封电子邮件取消订阅。

MSDN 和 TechNet 博客

状态：✅ 完成

我们已于 2019 年 7 月将 MSDN 博客和 TechNet 博客设置为只读。 MSDN 和 TechNet 博客已迁移并存档到 docs.microsoft.com/archive。

如果为任何 MSDN 或 TechNet 博客添加书签，指向这些博客的链接将重定向到 docs.microsoft.com/archive 上的新位置，或者重定向到其他博客网站（如果博客在积极维护和更新）。

状态：✅ 完成

我们已将所有 MSDN 代码库页面重定向到示例浏览器，并将关键示例存档到 MicrosoftArchive 组织中的 GitHub。 有关此过程的详细信息，请参阅最新的博客文章。

可以在 docs.microsoft.com/samples 上找到最新的代码示例。

状态：🚧 正在进行

TechNet 库将于 2020 年初停用。 2019 年 12 月，该网站将设置为只读，不再接受新的社区参与。 需要关注的其他公告和信息。

可以在 docs.microsoft.com/samples 上找到最新的代码示例。 如果你之前对 TechNet 库做了贡献，请确保将你的示例迁移到个人管理的位置，比如你自己的 GitHub 存储库。

TechNet Wiki

状态：🚧 正在进行

我们正在努力为 TechNet Wiki 创建更具体的迁移计划和安排。 请稍后回来查看更多详细信息。 现在，你可以继续参与并与 wiki 内容进行交互。

MSDN 和 TechNet 论坛

状态：🚧 正在进行

我们宣布了 Microsoft Q&A 的预览版，该版本取代了 MSDN 和 TechNet 论坛。 为了确保平稳过渡并最大程度减少中断，我们已将迁移分为多个阶段。 迁移可望在 2020 年中期完成。 请稍后回来查看更多详细信息。

Channel 9

状态：🚧 正在进行

对于以开发人员为中心的视频内容，第 9 频道仍是一项重要投资。 我们正努力打造一条迁移路经，以便更好地集成第 9 频道中的视频和技术内容。 请稍后回来查看更多详细信息。

我们想听听你的意见

我们很高兴继续对我们的平台进行投资，并确保你获得关于整个 Microsoft 生态系统的最相关和最可靠的技术文档。 请通过 GitHub 和 Twitter 与我们分享你的想法和改进建议。