Hacktoberfest 是 10 月舉行的一年一度的全球活動。 此事件鼓勵開放原始碼開發人員透過提取要求 (PR) 參與存放庫。 GitHub 裝載許多開放原始碼存放庫,這些存放庫對 Microsoft Learn 內容有貢獻。 數個儲存庫積極參與Hacktoberfest。
如何參與
在您可以對開放原始碼存放庫做出貢獻之前,必須先將您的帳戶設定為可在 Microsoft Learn 上進行貢獻。 如果您不熟悉此程式,請從註冊 GitHub 帳戶開始。 請務必 安裝 Git 和 Markdown 工具。
若要獲得參與信用,請向 Hacktoberfest 註冊並閱讀他們的參與指南。
尋找需要您協助的存放庫
PowerShell-Docs 小組支持數個 PowerShell 文件庫的 Hacktoberfest 貢獻。 我們定義了一組清理工作,專為新手參與者而設計,讓其簡單易行。 您可以在 Hacktoberfest 中繼問題中找到完整資訊。
若要成功執行這些工作,您應該:
- 對 PowerShell 語法有一般瞭解
- 瞭解 噴灑
- 能夠閱讀並遵循 PowerShell-Docs 樣式指南 和 編輯檢查清單
- 熟悉 Markdown 的基本知識
在參與之前應該先閱讀元議題。 當您準備好開始時,請使用下列其中一個鏈接開啟新的 Hacktoberfest:
- MicrosoftDocs/PowerShell-Docs
- MicrosoftDocs/PowerShell-Docs-DSC
- MicrosoftDocs/PowerShell-Docs-Modules
- MicrosoftDocs/windows-powershell-docs
- MicrosoftDocs/azure-docs-powershell
質量預期
若要成功參與開放原始碼Microsoft Learn存放庫,請建立有意義且具影響力的 PR。 下列來自官方 Hacktoberfest 網站的範例被視為 低質量的貢獻:
- 包含大量自動化變更的PR
- 範例:已編寫腳本的 PR 以移除空格符、修正一般拼字或優化影像
- 先提交問題,描述您想要進行的自動化變更
- PR 被視為干擾性 (例如,採取其他人的分支或認可並建立PR)
- 被認為是阻礙還是幫助的PR
- 顯然嘗試在 10 月增加 PR 計數的 PR
開啟 PR
PR 提供方便的方式,讓參與者提出一組變更。 成功的 PR 具有下列常見特性:
- 公關能提升價值。
- 參與者可接受意見反應。
- 預定的變更已清楚說明。
- 這些變更與現有問題有關。
如果您要提出沒有對應問題的PR,請先建立問題。 如需詳細資訊,請參閱 GitHub:關於提取要求。