GitHub 是共同作業平台

  • 8 分鐘

共同作業是 GitHub 所做一切的核心。 我們在課程模組的第一個單元中提過存放庫，並了解存放庫可協助您組織專案及其檔案。 在最後一個單元，我們已了解提取要求，這是追蹤專案變更的方式。

在此單元中，我們將了解問題和討論。 這些功能有助於 GitHub Enterprise Platform 的協作性質。

問題

GitHub 問題可用來追蹤 GitHub 上工作的想法、意見反應、工作或錯誤。 您可以透過各種方式建立問題，因此您可以選擇對您的工作流程而言最方便的方法。

本逐步解說涵蓋如何從存放庫建立問題。 您也可以從以下位置建立問題：

  • 工作清單中的項目。
  • 專案中的附註。
  • 問題或提取要求中的附註。
  • 特定程式碼。
  • URL 查詢。

從存放庫建立問題

  1. 在 GitHub.com 上，瀏覽至存放庫的主頁面。

  2. 在您存放庫的名稱下，選取 [問題]。

    顯示存放庫主頁面頂端部分的螢幕擷取畫面，其中已強調顯示 [問題] 區段。

  3. 選取 [新增問題]。

  4. 如果您的存放庫使用問題範本，請在您想要開啟的問題類型旁，選取 [開始使用]。

    如果您想要開啟的問題類型未包含在可用的選項中，請選取 [開啟空白問題]。 如果未使用範本，請跳至步驟 5。

    如果您的存放庫使用問題表單，您會看到要填寫的結構化表單，而不是空白的問題範本。 問題表單允許維護者以標準化格式收集特定資訊。

    問題範本功能表的螢幕擷取畫面，其中已強調顯示 [開啟空白問題] 選項。

  5. 在 [新增標題] 欄位中，輸入問題的標題。

  6. 在 [新增描述] 欄位中，輸入問題的描述。

  7. 如果您是專案維護人員，您可以將問題指派給某人、將其新增至專案面板、將其與里程碑產生關聯，或套用標籤。

  8. 完成後，選取 [提交新問題]。

使用標籤、提及和反應來有效管理協作並提高問題可見性。 問題範本有助於維持貢獻者的一致結構和期望。

某些對話可能更適合 GitHub 討論。 使用 GitHub 討論區來提問和回答問題、共用資訊、發佈公告，以及進行或參與有關專案的對話。

在下一節中，我們將會檢閱「討論區」，以及如何充分利用此功能。

討論

討論是針對不一定與程式碼相關的對話而設計，例如問答、想法或一般意見反應。 它們支援在共用論壇內進行開放、持續的通信，並且可以是公開的或私有的，具體取決於儲存庫的可見性。

在本節中，您將了解如何：

  • 在您的存放庫中啟用討論。
  • 建立新的討論和各種討論類別。

讓我們深入了解在您的存放庫中啟用討論。

在您的存放庫中啟用討論

存放庫擁有者和具有寫入存取權的擁有者可以在其公用和私有存放庫上為社群啟用 GitHub 討論。 討論的可見度會從建立其所在的存放庫繼承可見度。

當您第一次啟用 GitHub 討論時，系統會提示您設定歡迎文章。

  1. 在 GitHub.com 上，瀏覽至存放庫的主頁面。

  2. 在您存放庫的名稱下，選取 [設定]。

    存放庫主頁面頂端部分的螢幕擷取畫面，其中已強調顯示 [設定] 區段。

  3. 向下捲動至 [功能] 區段，然後在 [討論] 底下，選取 [設定討論區]。

    [討論] 方塊的螢幕擷取畫面，其中已強調顯示綠色的 [設定討論] 按鈕。

  4. 在「 開始新討論」下，編輯範本以符合社群的語氣和資源。

  5. 選取 [開始討論]。

您現在可以開始建立新的討論。

建立新的討論

可檢視存放庫的任何已驗證使用者都可以在該存放庫中建立討論。 對於組織層級討論，任何可以檢視來源儲存庫的使用者也可以建立討論。

  1. 在 GitHub.com 上，瀏覽至您要在其中開始討論之存放庫或組織的主頁面。

  2. 在您的存放庫或組織名稱下，選取 [討論]。

    存放庫主頁面頂端部分的螢幕擷取畫面，其中已強調顯示 [討論] 區段。

  3. 在頁面右側，選取 [新增討論]。

  4. 選取 立即開始來選擇討論類別。 所有討論都必須放在一個類別中。 儲存庫維護者定義這些類別。

    選取討論類別功能選取項目的螢幕擷取畫面，其中已強調顯示頂端選項 [公告] 和 [開始使用] 按鈕。

每個討論類別都包含一個獨特的名稱、表情符號和描述，以闡明其目的。 類別可協助維護人員組織交談的記錄方式。 其可自訂，以協助區分屬於問與答或更為開放式交談的類別。 下表顯示討論的預設類別及其用途。

類別 目的 格式
📣 公告 來自專案維護人員的更新和新聞 公告
#️⃣ 一般 與專案相關的任何項目和所有項目 開放式討論
💡 想法 變更或改善專案的想法 開放式討論
🗳️ 投票 使用多個選項進行投票，讓社群投票和討論 投票
🙏 問與答 社群要回答的問題，採用問答格式 問與答
🙌 顯示和告知 與專案相關的建立、實驗或測試 開放式討論

儲存庫維護人員可以將重要討論釘選到「討論」標籤的頂部，以獲得更好的可見性。

  1. 在 [討論標題] 下輸入討論的標題，然後在 [撰寫] 下輸入討論的本文。

    開始新討論頁面的螢幕擷取畫面，其中的 [討論標題] 方塊和內容方塊是空的。

  2. 選取 [開始討論]。

這涵蓋了 GitHub 如何透過問題和討論支援協作。 現在讓我們移至如何管理通知、訂閱執行緒，以及開始使用 GitHub 頁面。

將註解標示為答案

在 Q&A 樣式討論中，您可以將註解標示為原始問題的已接受答案。

  1. 瀏覽至討論。
  2. 找到最能回答原始問題的註解。
  3. 選擇評論下方的 標示為答案 。

評論將突出顯示，方便其他人快速找到解決方案。 如有需要，您也可以取消標記答案。

將討論轉換為問題

如果討論導致需要追蹤的工作，您可以將討論轉換為問題。

  1. 瀏覽至您想要轉換的討論。
  2. 選取位於討論右上角的...（三個點）選單。
  3. 選擇 轉換為議題。
  4. 確認轉換，然後選取要建立新問題的存放庫。

這會追蹤源自社群對話的可執行的工作。

釘選討論

您可以將重要討論釘選到「討論」頁面的頂端，以獲得更好的可見度。

  1. 瀏覽至您想要釘選的討論。
  2. 選取討論右上角的 ... (三個點) 功能表。
  3. 選取 [釘選討論]。

釘選的討論有助於強調顯示公告、重要問題或社群應注意的持續性主題。