Machine-parsable developers list
還沒有人認領這個 Issue。
- 主要語言
- Python
- 星號
- 2.1k
- 分支
- 1k
- 平均合併
- 2 天 12 小時
- 30 天內合併 PR
- 12
描述
We currently have several lists of developers, some manually maintained, some machine-generated, including:
- a machine-parsable list in the voters repo (private)
- a machine-generated (from the list above) developers.csv (in the devguide repo)
- a machine-generated (from the csv above) developer log (in the devguide)
- a separately-maintained list of experts (in the devguide repo)
- a machine-generated (from the list of experts above) nosy-list autocomplete on bpo (no longer used)
- a separately-maintained translators list (in the devguide)
- a separately-maintained CODEOWNERS file (in the cpython repo)
- possibly others (e.g. release managers), more or less related to list of core devs
I suggest to consolidate this into two lists:
- the one in the
votersrepo (private) can remain mostly unchanged - a new list in this repo can be created to list experts
The new list could use a similar format: listing users and fields about:
- their GitHub username
- and possibly the GitHub teams they belong to (to generate teams)
- see python/core-workflow#350
- the modules they maintain (to generate the
CODEOWNERSfile) - the modules, interest areas, platforms, translation languages they are interested in (to generate the expert index)
- the translator table could be moved back into the expert list
- see also #842
- the release manager table in the main page could be generated from this too
- the translator table could be moved back into the expert list
- possibly flags like
is_triager,is_core_dev,release_manager=<versions>,translator=<language>- these could be used to mark names in the expert index and to create RM and translator tables
- we could also have an
is_botfor bots
We should also move some info from the voters file to here, in particular the joined, left, notes info. This information is already public and by moving it here we will remove duplication and simplify the generation of developers.csv in this repo. The only remaining duplicated info between the two lists will be the GitHub username.
Some relevant links:
- PR that implemented a similar idea: #517
- Issue where the idea was proposed: #507
- Discourse message about listing maintainers
- Discourse message about notifying experts
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
先閱讀此 repository 中現有的 developers.csv、experts.rst、翻譯文件、CODEOWNERS 以及產生流程。在定義清單格式之前,檢視相關的 issue 和 PR #517、#507、#842 以及 python/core-workflow#350。當範圍已取得共識,且整合後的清單能在不重複維護的情況下產生已記錄的開發者與 ownership 輸出時,即表示完成。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- github, python
- 領域
- documentation, tooling
- Issue 類型
- 功能
- 難度
- 5/5
- 預估耗時
- 一週以上
- 活躍度
- 停滯
- 描述清晰度
- 基本清楚
- 新手友好度
- 25/100