歡迎! ??
Good First Issue是一項從熱門專案中輕鬆挑選的倡議,因此從未為開源做出過貢獻的開發人員可以快速入門。
開源維護者總是希望讓更多人參與進來,但新開發人員普遍認為成為貢獻者俱有挑戰性。我們相信讓開發人員解決超級簡單的問題可以消除未來貢獻的障礙。這就是 Good First Issue 存在的原因。
歡迎您在 Good First Issue 中新增項目,我們鼓勵所有項目—新舊、大小。
請依照以下簡單步驟操作:
我們的目標是縮小新開源貢獻者的專案範圍。為了保持 Good First Issue 中的專案質量,請確保您的 GitHub 儲存庫符合以下條件:
它至少有三個與good first issue
標籤相關的問題。預設情況下,該標籤已存在於所有儲存庫中。如果沒有,您可以按照此處的步驟操作。
它至少有 10 名貢獻者。
它包含包含專案詳細設定說明的 README.md,以及包含新貢獻者指南的 CONTRIBUTING.md。
它得到積極維護。
在 data/repositories.toml 中新增儲存庫的路徑(按字典順序)。
建立一個新的拉取請求。請在 PR 描述中新增指向儲存庫問題頁面的連結。合併拉取請求後,變更將在 goodfirstissue.dev 上生效。
Good First Issue 有兩個元件 - 使用 Nuxt.js 建立的前端應用程式和用 Python 編寫的資料填入腳本。
要向網站提供新功能和更改,您需要在本地運行該應用程式。請依照以下步驟操作:
將項目克隆到本地。確保您的電腦上安裝了 Python 3 和最新版本的 Node.js。
複製範例資料檔案以供本機應用程式使用,並將其重新命名為應用程式所需的檔案名稱。此步驟很重要,因為如果沒有這些資料文件,前端應用程式將無法運作。
$ cp 資料/產生的.sample.json 資料/產生的.json $ cp 資料/tags.sample.json 資料/tags.json
建立前端應用程式並啟動開發伺服器。
$ Bun install # 安裝依賴項 $ Bun dev # 啟動開發伺服器
該應用程式應在您的瀏覽器中開啟。