GitHub 是共同作業平台

已完成

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

在此單元中,我們將了解問題和討論。 這些是為 GitHub Enterprise Platform 共同作業本質有貢獻的另外兩個部分。

問題

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

針對本逐步解說,我們將探討如何從存放庫建立問題。 但問題的建立來源也可以是:

  • 工作清單中的項目。
  • 專案中的附註。
  • 問題或提取要求中的附註。
  • 特定程式碼。
  • 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 頁面。