docs.microsoft.com 簡介

2016-06-03

今天，我們將宣佈新文件服務的預覽版本 https://docs.microsoft.com，展示支援 Enterprise Mobility 產品的內容。

為什麼要 docs.microsoft.com？

簡言之，內容很重要。我們採訪並調查了數百名開發人員和 IT 專業人員，並篩選了多年來關於 UserVoice 的網站意見反應。很明顯，我們需要進行變更，併為內容建立現代化的Web體驗。我們做的第一件事是評估 TechNet 現有的內容基礎結構，並 MSDN。這兩個網站都是建置在 10-15 歲的脆弱程式代碼基底上，具有從未設計在雲端上執行的原型發佈和部署系統。

我們的焦點不僅是體驗，也在於我們建立的內容，以及您每個人取用它的方式。多年來，客戶已告知我們超越具有功能層級內容的文字牆，並協助他們實作其商務問題的解決方案。我們知道我們提供的內容，以及我們建置的平臺，必須讓客戶輕鬆學習和部署解決方案。

我們意識到要正確獲得從頭開始的整體體驗：這項工作 https://docs.microsoft.com 而來，這是Microsoft檔的新希望。

注意：此網站的預覽版本包含 Enterprise Mobility 檔案的內容 *only*（包含進階威脅分析、Azure Active Directory、Azure 遠端應用程式、Multi-Factor Authentication、Azure Rights Management、Intune和 Microsoft Identity Manager ]。未來，隨著我們的平臺隨著意見反應的協助而成熟，我們會將更多文件遷移至此體驗。

主要功能

讓我們從下面顯示的範例文件頁面開始，我們將展示網站上的一些新功能。

可讀性

為了改善內容可讀性，我們已將網站變更為一組內容寬度。眼追蹤研究已經表明，您可以使用一組內容寬度來改善理解和閱讀速度，因為眼睛很難沿著左至右長段落。為了顯示此動作，以下是在techNet上執行 docs.microsoft.com 之 Intune 文章的範例，後面接著TechNet上的相同文章。我們也增加了左側導覽和文字本身的字型大小，客戶一直在要求這些字型大小（UserVoice - 增加字型大小）。

估計閱讀時間

我們根據您的輸入所做的另一個簡單增強功能，就是為文章提供預估的閱讀時間。我們知道您中的許多人在會議之間學習/評估技術，如果您知道需要多少時間承諾，您更有可能閱讀文章。我們也已將日期戳記新增至內容，以協助客戶了解資訊如何以 UserVoice 意見反應為基礎。

根據客戶面試和 UserVoice 意見反應，投資的主要領域是根據客戶的意圖，改善網站導覽、資訊架構和內容組織。我們已將內容重構為關於評估、開始使用、規劃、部署、管理或疑難解答產品或服務的邏輯群組。您可以在左側導覽和產品/服務頁面中看到此內容細分。

以下是 Intune 檔首頁的螢幕快照：

此相同的分類也會在文章的左側導覽中：

縮短的發行項長度

另一個常見的意見反應是，我們的內容有時可能會是壓倒性的，因為它的長度和長的文章更難流覽，並找到您要尋找的內容。為了解決此問題，我們已將較長的文章細分為較小的邏輯步驟，並提供文章底部的 [上一步] 和 [下一步] 按鈕，以在多部分教學課程中的步驟之間流覽，如下所示。

雖然許多客戶喜歡擁有多部分教學課程的能力，但我們也聽到客戶想要將多步驟教學課程合併成單一離線印表機易用 PDF 的客戶。我們還沒有這個，但它即將推出預覽。

回應式設計

為了在行動裝置、平板計算機和計算機上建置絕佳的體驗，例如您在 UserVoice上，我們切換至回應式版面配置。按兩下 [選項] 按鈕將會展開/折疊，以顯示桌面檢視上的相同選項。

社群貢獻

docs.microsoft.com 的所有檔都是開放原始碼，並設計為允許社群貢獻。在已經開放原始碼檔的所有或部分Microsoft其他小組的腳步中，包括 ASP.NET、Azure、.NET Core，以及 Microsoft Graph。

每篇文章都有 [編輯] 按鈕（如下所示），它會帶您前往 GitHub 中的來源 Markdown 檔案，讓您可以輕鬆地提交提取要求來修正或改善內容。

意見反應機制

您的問題、批注和意見反應對我們很重要。我們已與 [Livefyre](https://web.livefyre.com/) 合作，提供所有文章的批注和側注。在每個文章頂端，您會看到批注的連結，如下所示。

單擊 [批注] 會帶您前往頁面底部，您可以在其中登入（使用 Twitter、Facebook、Google、Yahoo 或 Microsoft 認證）來新增、追蹤或喜歡批注。

底部

您也可以在每個內容段落或特別醒目提示的文字上新增 Sidenotes 或附注。若要這樣做，請在右邊的批註符號上按兩下滑鼠游標，以新增內嵌批註。

頁面頂端的共用按鈕可讓您輕鬆地與 Twitter 和 Facebook 共用。

您也可以使用滑鼠游標選取文章上的內容，直接從操作功能表在 Twitter 或 Facebook 上新增批註或共用，如下所示。

易記 URL

我們關心我們的 Web 體驗，以及一件事，經常錯誤我們作為 TechNet 和 MSDN 的使用者，文章沒有易讀的 URL。以下是使用新 URL 的相同文章範例。

之前：<https://technet.microsoft.com/library/dn646983.aspx>
之後：<https://learn.microsoft.com/intune/get-started/start-with-a-paid-subscription-to-microsoft-intune>

網站主題

我們也在文章中新增了主題選擇器，讓您可以在淺色和深色主題之間變更，有些您在 UserVoice上要求。

下圖顯示淺色和深色主題之間的差異。

基礎

網站效能等基本概念是一項重要功能，許多客戶要求我們改善 UserVoice。 docs.microsoft.com 的頁面載入時間在載入時間方面介於 50-300% 之間，而且我們比以往更適合異地分散。我們也建置在 Azure 上執行 100% 的架構上。

我們希望您的意見反應！

我們希望您享有 docs.microsoft.com 的預覽版本，請傳送意見反應給我們，以 https://aka.ms/sitefeedback。在未來的文章中，我們將討論我們的計劃，以大幅改善參考內容的體驗，以及我們的內容當地語系化計劃。

共用方式為