python / python/devguide

Machine-parsable developers list

オープン
#848 コメント 7 件 リアクション 1 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

help wanted infra type-feature
主要言語
Python
スター
2.1k
フォーク
1k
平均マージ
2日 12時間
マージ済み PR(30日)
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 voters repo (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 CODEOWNERS file)
  • 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
  • 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_bot for 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:

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

まず、このリポジトリにある既存の developers.csv、experts.rst、翻訳ドキュメント、CODEOWNERS、生成フローを読みます。リスト形式を定義する前に、関連する issue と PR #517、#507、#842、python/core-workflow#350 を確認します。スコープについて合意され、統合されたリストから、重複したメンテナンスなしに、文書化された開発者および ownership の出力を生成できれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
github, python
領域
documentation, tooling
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。