即將推出新的意見反應系統 docs.microsoft.com

這篇文章是由 docs.microsoft.com 團隊高級項目經理羅布 ·艾森伯格羅布·艾森伯格撰寫的。

Microsoft的使命是賦予地球上每個人和每個組織更多成就的能力。 這是我們 在開放式 GitHub 平臺之上建置 docs.microsoft.com 的考慮之一。 今天，我們會將它移至以 GitHub 為基礎的新文件意見反應系統，進入下一個層級。

GitHub 上的內容意見反應

雖然我們的檔自一開始就在 GitHub 上，但我們的內容意見反應機制一直使用 Livefyre 來評論文章。 雖然 Livefyre 是絕佳的批注解決方案，但事實證明，它不足以滿足我們的特定需求，也就是追蹤、指派擁有者，以及維護客戶所引發的內容問題狀態。

我們探索了一些途徑，使其變得更好，但一個引導我們大部分工作的問題似乎重新浮出水面：如果我們的文件被視為開放原始碼，我們會使用什麼來解決這個問題？ 問題答案似乎很明顯：GitHub 問題，因此我們開始嘗試更深入地整合 GitHub API 到我們的文件頁面，能夠在 GitHub 基礎結構之上建置完整的意見反應系統。

有了新的系統，您現在可以直接從內容頁面建立 GitHub 問題，這可讓您以更豐富的方式與作者和產品小組互動。 請參閱文件的問題嗎？ 程式代碼範例不正確？ 令人困惑的解釋嗎？ 重大遺漏？ 只要捲動至頁面底部，然後選取 [提供檔意見反應。

您可以直接從文件頁面本身查看與文件相關聯的所有開啟和已關閉問題，如此一來，您就一律知道何時修正並解決：

您可以批注，甚至 將回應新增至對您很重要的問題：

現在，Microsoft員工可以利用 GitHub 問題的完整功能，對回報的問題進行分級、回應、規劃和修正，而且您永遠都能看到此程式！

範例文件意見反應

假設您在文章上提出中斷超連結的 GitHub 問題。 我們的小組會分級問題、指派標籤，並指派擁有者進行修正（或詢問後續問題）。 當擁有者提交修正問題的提取要求時，您會收到通知（根據您的 GitHub 通知設定），問題已解決/關閉，建立意見反應的良性迴圈。

此外，您可以利用所有標準 GitHub 良好，例如批注中的 Markdown、個別問題的訂閱或整個存放庫、組織活動的 RSS 摘要、@ 提及、被指派者等等！ 我們相信，更深入的開放原始碼工具整合將促進社群成長和共同作業的新機會。

產品意見反應的分離

上一個系統的問題之一是產品與文件意見反應之間的混合在一個數據流中 -- 當並非所有專案都一致標示時，很難分級和後續操作。 我們採取了一步來修正此問題，方法是建立一個明確的方法來分隔這兩者：

單擊 [提供產品意見反應，您現在將直接前往與特定文件頁面相關聯的產品小組處理產品意見反應的網站。

Roll-Out

您可能想知道意見反應系統何時會上線。 我們已針對 Visual Studio IDE 和 Azure CLI 檔試驗了幾個月。 從 2 月中旬開始，我們將從所有 docs.microsoft.com 開始推出。

您的意見反應

您的意見反應對我們很重要，因此我們想要快速將這個新系統放入您的手中。 雖然這是我們改善平臺上意見反應和參與的下一步，但絕不是我們的最後一個步驟。 請務必在 GitHub 上表達您對變更的看法，或在 Twitter 上標記。