MSDN 與 TechNet 移轉至 docs.microsoft.com 的更新
「此文章是由開發人員關係企業副總裁 Jeff Sandquist 所撰寫。」
今天,我們很高興能為您提供 MSDN 與 TechNet 內容移轉至 docs.microsoft.com 的重要更新。 這篇部落格文章記載全公司努力成果的最後幾個步驟,全面修改內容結構、格式和基礎結構,並將 Microsoft 技術文件集中於一個網站上。
回到 1992 年,Microsoft Developer Network 作為客戶訂閱服務而誕生,以提供 Windows 程式設計的技術資訊。 六年後,我們在 1998 年啟動了 MSDN Online 網站,其裝載超過 25 萬頁的內容。
在那時,發佈流程包含在 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,以及我們的範例程式碼瀏覽器。
有了現代化的平台之後,我們便著手確保珍貴內容不會在移轉至新網站的過程中遺失。 您可以在下面找到有關進度的詳細資訊。
狀態: ✅ 完成
我們從 2017 年下旬開始將 MSDN 程式庫 與 TechNet 程式庫移轉至 docs.microsoft.com,並已於今年完成移轉。
這些程式庫在先前提供了適用於 Microsoft 產品的文件,包括 API 文件、範例程式碼和技術文章。 這些內容原本是透過 CD 提供,而其隨著 MSDN 與 TechNet 網站啟動後,便被移至線上。
針對人類編輯的內容與用於自動產生 API 文件的 YAML,移轉需要將各種以 XML 為基礎的格式轉換為 Markdown,這項移轉橫跨了 100 種內容集。 我們已經確保已針對數百萬個網頁進行頁面重新導向,以防止參考網站外部的中斷連結,例如部落格和論壇。
為了讓您更加了解我們所完成的內容量,以下為一些項統計資料:
- 可用的 MSDN 和 TechNet 主題數目: 45.4MM
- 移轉至 docs.microsoft.com/previous-versions 的主題數目: 23.0MM
- 移轉至 docs.microsoft.com 的主題數目: 21.0MM
- 建立用來裝載 docs.microsoft.com/previous-versions 內容的存放庫數目: 2,454
如果您已將任何 MSDN 或 TechNet 內容加入書籤,則這些連結將會完好地重新導向至其在 docs.microsoft.com 上的新位置。
狀態: ✅ 完成
MSDN Magazine 的最後一期是於 2019 年 11 月 1 日發佈。 我們在 8 月版的 MSDN Magazine 中,向讀者與作者告知了停刊訊息。
曾在 MSDN 發佈的 MSDN Magazine 內容現已移至 docs.microsoft.com/archive。
對於付費的 MSDN Magazine 訂閱者,會依據其訂閱的剩餘時間按比例退款。 退款支票會於 11 月的期刊發佈之後寄送。 這項變更並不會影響 MSDN 平台的訂閱。
狀態: ✅ 完成
曾在 MSDN 與 TechNet 發佈的電子報現已移至 docs.microsoft.com/archive。
目前的訂閱者會繼續收到這些電子報, 但我們可能會改進並變更格式,以及發佈排程。
如果不想再訂閱我們的電子報,您可以在所收到的下一封電子郵件中取消訂閱。
狀態: ✅ 完成
我們已在 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 實施更具體的移轉計劃與排程。 如需其他詳細資料,請稍後再回來查看。 您現在仍可以繼續參與 Wiki 內容並與其互動。
狀態: 🚧 進行中
我們宣告了 Microsoft 問與答的預覽版本,其取代 MSDN 與 TechNet 論壇。 為了確保移轉順暢,並將干擾降到最低,我們已將移轉分成多個階段。 而我們預計在 2020 年中旬完成移轉。 如需其他詳細資料,請稍後再回來查看。
狀態: 🚧 進行中
針對以開發人員為主的影片內容,Channel 9 一直以來都是一項重要的投資。 我們正致力於打造移轉路徑,以將我們在 Channel 9 中的影片與技術內容更完善地整合。 如需其他詳細資料,請稍後再回來查看。
我們很高興能繼續投資我們的平台,並確保您能取得整個 Microsoft 生態系統最相關且最可靠的技術文件。 請在 GitHub 與 Twitter 上提供您的想法與改善建議。