這篇文章是由 雲端 + 企業部總經理傑夫·桑德奎斯特傑夫·桑德奎斯特撰寫的。
今天,我們宣佈與 Stack Overflow 合作,以支援Microsoft開發人員的 Stack Overflow 檔。 在此公告中,我們宣佈 Stack Overflow 文件內容將會在未來整合至 docs.microsoft.com API 參考內容。 Microsoft長期以來一直是 Stack Overflow 的合作夥伴,其形式為贊助標籤,而 Stack Overflow 檔的推出可讓社群輕鬆地使用 .NET Framework、Xamarin 和其他Microsoft產品和技術來建立和投票程式代碼範例。
共用目標
docs.microsoft.com 和 Stack Overflow 都有共同的目標,我們希望讓社群輕鬆且簡單,為使用產品和服務提供絕佳的檔。 這兩組內容都有開放式授權、使用 Markdown 作為內容格式,並輕鬆地啟用社群貢獻(按兩下任何 docs.microsoft.com 頁面的 [編輯]。
適用於 .NET 開發人員的 Stack Overflow 快速導覽
當您第一次抵達 StackOverflow 檔時,您會發現可用主題的熟悉標記型分類。 第一眼,您會看到 StackOverflow 社群先前建立的所有標籤。 一旦您依標記篩選,每個清單就會顯示一些重要計量,其前面會顯示一些重要計量-主題要求計數、建議的變更和改進要求。
要求主題
沒有 StackOverflow 對象的協助,很少有開發人員解決了困難問題。 我們與社群的同事、同儕和圖例一起,他們監視 StackOverflow,以取得與其產品相關的問題,我們建立了由標記組織的信息網路。 檔利用對象承諾,藉由給我們一個要求協助的地方來共同建置知識-每個標籤的「要求的主題」一節可讓社群找出常見問題。
按兩下 [建立主題],您可以建立主題的內容,並提供您自己的程式碼範例和檔。 此體驗提供提供每個內容區段的指引,如果您偏好的話,可以使用 Markdown 語法進行編輯。 當您建立主題時,進度會儲存在正確的導覽中,您可以在其中查看尚未完成或傳送以供檢閱的所有草稿內容。
熟悉的程式代碼檢視體驗
如同 StackOverflow Q&A 網站,個別主題的程式代碼會以清楚、簡潔的格式呈現,讓您只要閱讀程式碼即可複製-編輯-使用或學習。 開發人員可以上下投票程式代碼範例,就像 Stack Overflow 上的答案一樣。
未來的整合
未來,docs.microsoft.com 會將 Stack Overflow 檔範例的策劃清單直接整合到 Microsoft API 檔中。 查看Microsoft API 參考的開發人員會看到Microsoft所建立的範例,以及社群所建立的 Stack Overflow 範例。 系統會策劃這些範例,以確保程式碼範例使用已建立的 .NET 程式代碼撰寫指導方針和最佳做法。 我們將在未來發佈更多有關此整合的詳細數據。