python / python/docs-community

Move language selection to a dedicated page?

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

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

discussion topic:internationalization
Ngôn ngữ chính
Makefile
Star
55
Fork
26
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

I have been browsing various documentation sites, as part of exploration for #1, and I quite like how React has handled their presentation for the documentation translations: https://reactjs.org/languages

By having a separate page, the page can now contain:

  • Clear indicators for the "state" / "completeness" of the translation efforts, like "In Progress" and "Needs Contributors".
  • Clear links to contribute to each of the language-specific translation efforts.
  • Callout to a documentation page, for folks interested in contributing additional languages.
  • A lot more space to present translations across many languages. :)

I think all of these are basically non-feasible for a dropdown-based language selector like we have today on docs.python.org.

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

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

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

Xem xét bộ chọn ngôn ngữ hiện tại dựa trên menu thả xuống và so sánh với trang ngôn ngữ React được liên kết trong issue. Xác định các chỉ báo trạng thái bản dịch, các liên kết đóng góp và hướng dẫn thêm ngôn ngữ cho trang chuyên dụng; công việc được xem là hoàn tất khi các yêu cầu này được trình bày rõ ràng bằng nhiều ngôn ngữ.

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

Đánh giá

Lĩnh vực
documentation
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
35/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.