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 網站，其裝載超過 25 萬頁的內容。

1999 年 MSDN Online 的螢幕擷取畫面

在那時，發佈流程包含在 Microsoft Word 中建立內容、轉換成 HTML，並透過稱為 pubwiz (「發佈精靈」) 的工具發佈。 而過去 20 年來，這項流程支援了各種新產品、服務和更新的發行，導致我們的技術內容最後高達 4 千 5 百萬頁！

隨著產品發行週期從數年縮短到數個月，存取最新文件的需求也會增加。 由於發佈系統需要符合工程速度，因此我們決定重新設計在雲端時代管理 Microsoft 文件的方式。 在 2015 年 11 月，docs.microsoft.com 小組的創始成員 Dan Fernandez、Mary McHale、Carol Zeumault 和 Jeff Sandquist 撰寫了名為「新的希望」(「向星際大戰第 4 集致敬」) 的文件，其概述了對新網站的願景。 而其中包含了一套重要的指導原則：

  • 統一的技術文件。 這個新網站應該要合併 Microsoft 所裝載的數十個文件網站。 想要學習如何建立資料驅動 Web 應用程式的開發人員，只需要造訪一個網站，即可找到 ASP.NET、Azure、Entity Framework 或任何其他 Microsoft 技術的相關內容。
  • 改善的使用者體驗。 要定義網站成功的關鍵因素，便是其為客戶提供的體驗。 這個新網站應該要有更好的載入效能、可讀字型、可存取的內容資料表、一般人看得懂的 URL、版本設定支援、與行動瀏覽器的相容性，以及透過可存取的功能與國際化支援以遵循包容性設計的做法。
  • 製作與社群參與普及化。 這個新網站應由開放原始碼標準與工具提供技術支援，讓任何人都能夠建立和編輯文件。 其應該使用 Markdown 的內容、用於自動產生 API 文件的 YAML，並以 GitHub 作為基礎內容層 (可允許使用自動品質檢查)。 MicrosoftDocs GitHub 組織已經擁有超過 7400 名成員，而 Azure 文件存放庫則是成長最快速的開放原始碼專案(「年成長 470%」)，且在所有 GitHub 中對存放庫的貢獻為第 5 名，如 The State of the Octoverse 2018 中所述！
  • 支援 API 文件。 新網站對於針對程式設計語言和平臺所撰寫的 API 檔應具有第一級支援，包括 .NET、 Java、 Python、 JavaScript 和 TypeScript、 PowerShell、 Azure CLI、 Q#、 OpenAPI 等等。 這項體驗應該由自動化提供技術支援，具備可靠的 API 涵蓋範圍，並可以在幾分鐘內就發佈 API 文件，而不需要數週。
  • 工程基礎結構現代化。 docs.microsoft.com 應該在 Azure 上執行，讓我們能夠降低維護成本 (「可節省超過美金 $7 百萬元」)、改善部署時間，從每三週縮短至每天 (「或更快」) 並減少工程重複。
  • 預設為可延伸。 隨著這個網站發展，其必須能夠以最有效率的方式滿足客戶需求。 藉由這項承諾，我們得以建立並整合全新的互動式學習體驗 - Microsoft Learn，以及我們的範例程式碼瀏覽器。

有了現代化的平台之後，我們便著手確保珍貴內容不會在移轉至新網站的過程中遺失。 您可以在下面找到有關進度的詳細資訊。

MSDN 與 TechNet 程式庫

狀態： ✅ 完成

我們從 2017 年下旬開始將 MSDN 程式庫 與 TechNet 程式庫移轉至 docs.microsoft.com，並已於今年完成移轉。

這些程式庫在先前提供了適用於 Microsoft 產品的文件，包括 API 文件、範例程式碼和技術文章。 這些內容原本是透過 CD 提供，而其隨著 MSDN 與 TechNet 網站啟動後，便被移至線上。

針對人類編輯的內容與用於自動產生 API 文件的 YAML，移轉需要將各種以 XML 為基礎的格式轉換為 Markdown，這項移轉橫跨了 100 種內容集。 我們已經確保已針對數百萬個網頁進行頁面重新導向，以防止參考網站外部的中斷連結，例如部落格和論壇。

為了讓您更加了解我們所完成的內容量，以下為一些項統計資料：

如果您已將任何 MSDN 或 TechNet 內容加入書籤，則這些連結將會完好地重新導向至其在 docs.microsoft.com 上的新位置。

MSDN Magazine

狀態： ✅ 完成

MSDN Magazine 的最後一期是於 2019 年 11 月 1 日發佈。 我們在 8 月版的 MSDN Magazine 中，向讀者與作者告知了停刊訊息。

曾在 MSDN 發佈的 MSDN Magazine 內容現已移至 docs.microsoft.com/archive。

對於付費的 MSDN Magazine 訂閱者，會依據其訂閱的剩餘時間按比例退款。 退款支票會於 11 月的期刊發佈之後寄送。 這項變更並不會影響 MSDN 平台的訂閱。

Microsoft 開發人員與 TechNet Flash 電子報

狀態： ✅ 完成

曾在 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 問與答的預覽版本，其取代 MSDN 與 TechNet 論壇。 為了確保移轉順暢，並將干擾降到最低，我們已將移轉分成多個階段。 而我們預計在 2020 年中旬完成移轉。 如需其他詳細資料，請稍後再回來查看。

Channel 9

狀態： 🚧 進行中

針對以開發人員為主的影片內容，Channel 9 一直以來都是一項重要的投資。 我們正致力於打造移轉路徑，以將我們在 Channel 9 中的影片與技術內容更完善地整合。 如需其他詳細資料，請稍後再回來查看。

我們很樂於聽取您的意見

我們很高興能繼續投資我們的平台，並確保您能取得整個 Microsoft 生態系統最相關且最可靠的技術文件。 請在 GitHub 與 Twitter 上提供您的想法與改善建議。