共用方式為


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

這篇文章是由 傑夫·桑德奎斯特公司副總裁開發人員關係撰寫的。

今天,我們很高興提供 msDN 移轉的重要更新,並 TechNet 內容 docs.microsoft.com。 此部落格文章記載了全公司努力徹底改革內容結構、格式和基礎結構的最後幾個步驟,並集中化一個網站周圍的Microsoft技術檔。

從 MSDN 和 TechNet 到 docs.microsoft.com

早在 1992 年,Microsoft 開發人員網路就誕生 為客戶訂用帳戶服務,以提供 Windows 程式設計的技術資訊。 六年後,1998年,MSDN Online 網站推出,裝載了超過25萬頁的內容。

1999 年 MSDN Online 螢幕快照

然後,發佈程式是由在 Word Microsoft 中建立內容、將其轉換成 HTML,以及透過名為 pubwiz 的工具發佈(發佈精靈)。 20 多年來,此程式支持發行新產品、服務和更新,導致驚人的4500萬頁技術內容!

隨著產品發行週期從年到數月的轉變,對無障礙 up-to日期檔的需求不斷增加。 發佈系統需要符合工程速度,因此我們決定重新發明如何在雲端時代Microsoft管理檔。 2015年11月,docs.microsoft.com丹·費爾南德斯瑪麗·麥克哈利卡羅爾·澤莫傑夫·桑德奎斯特 寫了一份名為“新希望”的檔(對《星球大戰》第四集的敬意),概述了新網站的願景。 它包含一組主要指導原則:

  • 統一技術檔。 新網站應合併由Microsoft裝載的數十個文件網站。 瞭解如何建立數據驅動 Web 應用程式的開發人員只需要流覽一個網站,才能在 ASP.NET、Azure、Entity Framework 或任何其他Microsoft技術上尋找所有相關內容。
  • 改善的用戶體驗。 定義網站成功的關鍵因素是它為客戶提供的體驗。 新網站應具有更好的載入效能、可讀取字型、可存取目錄、人類可讀取的 URL、版本設定的支援、與行動瀏覽器的相容性,並遵循包容性設計 做法,透過無障礙功能支援國際化
  • 民主黨化撰寫和社區參與。 新網站應由開放原始碼標準和工具提供,讓任何人能夠建立和編輯檔。 它應該使用 Markdown 作為內容、YAML 來自動產生的 API 檔,並依賴 GitHub 作為基礎內容層,這可允許使用自動化質量檢查。 MicrosoftDocs GitHub 組織已成長為超過 7,400 個成員, 而 Azure 檔存放庫 是成長最快的開放原始碼專案之一(470% 年年),也是所有 GitHub 中貢獻最多的第 5 個存放庫,如 2018 年 10 月 2018 年 10 月狀態的 所示!
  • 支援 API 檔。 新網站應具備針對程式設計語言和平臺撰寫之 API 檔的第一級支援,包括 .NETJavaPythonjavaScript 和 TypeScriptPowerShellAzure CLIQ#OpenAPI 等等。 體驗應由自動化提供、具有可靠的 API 涵蓋範圍,且能夠在數分鐘內發佈 API 檔,而不是數周。
  • 現代化工程基礎結構docs.microsoft.com 應該在 Azure 上執行,讓我們能夠降低維護成本(節省超過 7MM美元),改善從每三周到每天的部署時間(或更快的),並減少工程重複。
  • 根據預設,可延伸。 隨著網站的發展,它必須能夠以最有效率的方式滿足我們的客戶需求。 藉由做出此承諾,我們能夠建置並整合全新的互動式學習體驗 -Microsoft Learn,以及我們的 範例程式代碼瀏覽器

有了新式平台,我們著手確保我們不會藉由將內容移轉至新網站來遺失寶貴的內容。 您可以在下方找到有關進度的詳細資訊。

MSDN 和 TechNet 連結庫

狀態:✅ 完成

我們於 2017 年底開始將 MSDN 連結庫TechNet Library 移轉至 docs.microsoft.com,並在今年完成移轉。

這些連結庫先前提供Microsoft產品的檔,包括API檔、範例程式代碼和技術文章。 最初可透過CD提供,內容稍後會隨著MSDN和TechNet網站的推出而上線。

移轉需要將各種 XML 格式轉換成 Markdown,以供人類編輯的內容使用,而 YAML 則適用於自動產生的 API 檔,跨越一百多個各種內容集。 我們已確保數百萬個網頁已備妥頁面重新導向,防止網站外部參考的鏈接中斷,例如部落格和論壇。

為了讓您一瞥我們所處理的內容量,以下是一些統計數據:

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

MSDN Magazine

狀態:✅ 完成

MSDN 雜誌的最後一期於 2019 年 11 月 1 日出版。 我們在 MSDN Magazine 版的讀者和作者 傳送了 最後的訊息。

MSDN 上發佈的 MSDN Magazine 內容已移至 learn.microsoft.com/archive

支付訂閱費用的 MSDN Magazine 訂閱者將會根據訂閱剩餘的時間,收到按比例計算的退款。 退款支票將在 11 月發行後寄出。 這項變更不會影響 MSDN 平台訂用帳戶。

Microsoft開發人員和 TechNet Flash 電子報

狀態:✅ 完成

MSDNTechNet 上發佈的電子報已移至 docs.microsoft.com/archive

目前的訂閱者將繼續收到這些電子報。 我們可能會進化並變更格式以及出版物排程。

如果您不想再訂閱我們的電子報,您可以取消訂閱您收到的下一封電子郵件。

MSDN 和 TechNet 部落格

狀態:✅ 完成

我們已 MSDN 部落格TechNet 部落格 網站只讀於 2019 年 7 月。 MSDN 和 TechNet 部落格已移轉並封存至 docs.microsoft.com/archive

如果您已將任何 MSDN 或 TechNet 部落格加入書籤,這些部落格的連結會重新導向至 docs.microsoft.com/archive上的新位置,或如果這些部落格網站已主動維護及更新部落格,則會重新導向至其他部落格網站。

狀態:✅ 完成

我們已將所有 MSDN 程式代碼庫頁面重新導向至 範例瀏覽器,並將主要範例封存到 MicrosoftArchive 組織中的 GitHub。 請 我們最近的部落格文章深入瞭解此程式。

您可以在 docs.microsoft.com/samples上找到最 up-to日期的程式代碼範例。

狀態:進行中 🚧

TechNet 資源庫將於 2020 年初淘汰。 2019年12月,該網站將只讀不再接受新的社區貢獻。 要遵循的其他公告和資訊。

使用 docs.microsoft.com/samples 尋找最 up-to日期程式代碼範例。 如果您先前已參與 TechNet 資源庫,請務必將範例遷移至個人管理的位置,例如您自己的 gitHub 存放庫

TechNet Wiki

狀態:進行中 🚧

我們正在制定更具體的移轉計劃和排程,TechNet Wiki。 請稍後返回,以取得其他詳細數據。 您目前可以繼續參與Wiki內容並與其互動。

MSDN 和 TechNet 論壇

狀態:進行中 🚧

我們宣佈了 Microsoft Q&A的預覽版本,此版本取代了 MSDN 和 TechNet 論壇。 為了確保順暢的轉換並將中斷降至最低,我們已將移轉細分為多個階段。 我們預計到 2020 年年中完成移轉。 請稍後返回,以取得其他詳細數據。

通道 9

狀態:進行中 🚧

Channel 9 仍然是開發人員專注影片內容的重要投資。 我們正致力於移轉路徑,以更好地整合來自 Channel 9的影片和技術內容。 請稍後返回,以取得其他詳細數據。

我們希望聽到您的意見

我們很高興繼續投資我們的平臺,並確定您獲得整個Microsoft生態系統最相關且可靠的技術檔。 請提供您對 GitHub Twitter 的想法和改進建議。