python / python/devguide

Machine-parsable developers list

Đang mở
#848 7 bình luận 1 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

help wanted infra type-feature
Ngôn ngữ chính
Python
Star
2.1k
Fork
1k
Merge trung bình
2 ngày 12 giờ
Pull request đã merge (30 ngày)
12

Mô tả

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:

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu bằng cách đọc các tệp hiện có developers.csv, experts.rst, tài liệu dịch, CODEOWNERS và luồng tạo trong repository này. Xem xét các issue và PR liên quan #517, #507, #842 và python/core-workflow#350 trước khi xác định định dạng danh sách. Công việc được xem là hoàn tất khi phạm vi đã được thống nhất và danh sách hợp nhất có thể tạo ra các đầu ra về developer và ownership được ghi thành tài liệu mà không cần bảo trì trùng lặp.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
github, python
Lĩnh vực
documentation, tooling
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
25/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.