.NET Core 文件簡介

發行項
2016/06/24

今天，我們發行了 docs.microsoft.com上 .NET 檔預覽版。若要深入瞭解新的文件體驗改進 docs.microsoft.com 供應專案，請流覽 docs.microsoft.com 部落格文章。除了在 docs.microsoft.com 平臺上提供所有共同作業功能、開放原始碼內容和更友好的 URL 之外，我們也引進了一些 .NET 開發人員專屬的新功能。本文將醒目提示這些新功能，並摘要說明我們未來的計劃。

.NET 檔體驗的亮點

為了伴隨令人振奮的 .NET Core RTM 版本，我們將它放在 .NET 檔首頁的前面和中央。為了補充 .NET Core RTM 版本與快速開始使用所需的一切，我們已將文章的連結和新的參考體驗放在清單頂端。

指尖上的 .NET 生態系統

您會看到下載新 .NET Core 連結庫的連結，ASP.NET、Entity Framework、Azure、使用 Xamarin 使用 .NET 建置 iOS 應用程式，以及使用 .NET 建置通用 Windows 平臺（UWP）應用程式。我們尚未將所有 .NET 內容移至 docs.microsoft.com，但 .NET 檔首頁將會是您取得所有 .NET 檔的起點。

文章

我們的作者和工程師，以及一些專門的社群成員，一直在不知疲倦地建立新的 .NET Core 相關文章，您可以在 .NET 檔一節中找到。您可以在這裡找到一系列文章，例如：

這些和其他許多主題全都呈現在 docs.microsoft.com 主題中，每個頁面上都有一份乾淨的目錄，以及閱讀每個文章的每個文章和參與者信息的估計時間。

所有 .NET 文章都是開放原始碼，可在 .NET 小組的檔存放庫 GitHub 取得。如果您在檔中發現任何問題，或想要加以改善，只要按下每個文章右側導覽中的 [編輯] 按鈕即可。

編輯文章很簡單，只要按兩下存放庫中任何 Markdown 檔案的編輯按鈕、新增您的內容，以及提交提取要求即可。一旦我們的小組檢閱並接受您的提取要求，您的貢獻將會在幾分鐘內在網站上線。

API 參考

除了作者、工程師和充滿激情社群成員所撰寫的絕佳內容之外，我們也對參考體驗進行了重大改進。此預覽版本中已完全重新設計參考體驗，並借用我們在 docs.microsoft.com 文章中使用的相同設計原則。

與這些文章一樣，新的參考頁面具有回應性、使用新式 Web 原則設計，而且在行動裝置上看起來會更好。

參考回應式設計

我們已將 類型搜尋 新增至所有命名空間頁面。這可讓您輕鬆地依類型名稱搜尋所有 .NET 類型。在每個按鍵的情況下，我們會篩選左側導覽中顯示的類型清單。這個令人興奮的參考區域新功能包含在我們的新架構中，用於產生稱為 DocFX的 .NET 參考檔，這是 GitHub 上的開放原始碼專案）。

當您在任何命名空間的左側導覽中按下個別類型時，您會直接跳至該類型的命名空間頁面簡介區段。按兩下參考內容主要區域中的類型名稱，您會看到類別的詳細數據頁面，其中包含類別的繼承鏈結、宣告，以及類別屬性和方法成員的詳細數據。

針對每個方法成員，您會看到參數的詳細數據，以及方法的摘要。

資訊與工程原則

除了持續開發和改進 DocFX 檔案產生工具之外，我們還對工程和文件原則進行了大幅改善，您會在新的 .NET 檔案體驗中看到這些原則。

更好的自動化

從潛在參與者收到提取要求時，我們會驗證參與者已遵循簽署參與者許可協定的簡單程式（此程式是完全電子的，需要幾分鐘才能完成）。只要貢獻遵守貢獻指導方針，在接受提取要求后幾分鐘，就應該在網站實時顯示小變更。

更好的 URL

整體 docs.microsoft.com 體驗的一個重要原則是改善搜尋索引編製和「猜測」的 URL。我們已在 .NET 檔中維護此原則。文章和參考檔都有更清楚的 URL。例如，系統命名空間的傳統 MSDN URL：

MSDN系統命名空間 URL

在新的參考檔中，URL 更具有邏輯性、可讀性，而且最重要的是，更容易探索。

docs.microsoft.com系統命名空間 URL

更敏捷且開放撰寫

內容不僅開放原始碼，而且我們不僅接受社群貢獻。此外，docs.microsoft.com 上的所有內容（包括 .NET 檔）全都可以在 Creative Commons 授權下取得。您可以讀取、複製、參考它，以及重複使用其部分（甚至用於商業用途）。作家和工程師在新系統中積極與社區成員合作數月。這是一個有趣和令人興奮的過渡，我們有更多的未來來。

未來計劃

這一部分的 docs.microsoft.com，就像網站的其他部分一樣，仍處於預覽狀態，因此我們鼓勵建設性的意見反應和評論。請將您的功能構想提交至 UserVoice。

在未來幾周內，我們將發佈 XML 批注，這些批注將用來直接產生參考檔到 .NET 原始程式碼中。這可讓任何人輕鬆按兩下更新 .NET Framework 參考檔。
我們也會繼續調整參考的設計和版面配置，以及上述編輯參考內容本身的能力。

我們很高興能將新的 .NET 檔區域帶到 docs.microsoft.com，我們期待著日後讓您的體驗變得更好！

共用方式為