Clarify issue/PR choreography
還沒有人認領這個 Issue。
- 主要語言
- Python
- 星號
- 2.1k
- 分支
- 1k
- 平均合併
- 2 天 12 小時
- 30 天內合併 PR
- 12
描述
From a discussion with @picnixz:
I think the problem with the devguide is the first sentence is "Create an issue that describes the change" and you'll see the mention to DPO only during creation. We can improve that
I would expect people to read the issue template correctly and understand that something is not trivial
and more importantly: WAIT for triagers to decide whether it's ok or not as an issue
There are obvious cases where the issue doesn't a triager for validation, like a clear bug (and even this is subject to interpretation sometimes) but the process issue+PR is the worst for triagers, especially when the PR is automated.
This might be a duplicate of other feedback here in issues, but I wanted to capture it before going back to $WORK.
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
首先定位 devguide 的開頭說明和 issue 範本,然後檢查 DPO 和 triager 指引內容是在何處引入的。明確說明 contributors 應在 triager 驗證後再開啟 PR,同時指出圍繞明確 bug 的討論。只要 issue-to-PR 工作流程和例外情況對 contributors 都有明確說明,就算完成。
由索引模型根據 Issue 內容生成。
評估
- 領域
- documentation
- Issue 類型
- 文件
- 難度
- 3/5
- 預估耗時
- 1-2 天
- 活躍度
- 活躍
- 描述清晰度
- 基本清楚
- 新手友好度
- 52/100