閱讀英文

共用方式為


MSDN 與 TechNet 移轉至 docs.microsoft.com 的更新

「此文章是由開發人員關係企業副總裁 Jeff Sandquist 所撰寫。」

今天,我們很高興能為您提供 MSDNTechNet 內容移轉至 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 FernandezMary McHaleCarol ZeumaultJeff 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 檔應具有第一級支援,包括 .NETJavaPythonJavaScript 和 TypeScriptPowerShellAzure CLIQ#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 電子報

狀態: ✅ 完成

曾在 MSDNTechNet 發佈的電子報現已移至 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 生態系統最相關且最可靠的技術文件。 請在 GitHubTwitter 上提供您的想法與改善建議。