python / python/python-docs-pt-br

Prover documentação para download

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

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

Ngôn ngữ chính
Python
Star
164
Fork
42
Merge trung bình
14 giờ 32 phút
Pull request đã merge (30 ngày)
4

Mô tả

Em https://docs.python.org/pt-br/3.13/download.html temos a documentação para download em vários formatos.

Foi iniciada uma discussão quanto à disponibilidade desses arquivos, e uma questão levantada é se isso precisa mesmo ser feito pelo time do núcleo ou poderia ser feito por outro time.

Então, gostaria de que nos adiantassemos a isso e fizemos esse geração para disponibilidades dos arquivos em python.org.br

Mas com algumas diferenças em relação ao que é feito atualmente.
Além dos arquivos compactados, disponibilizamos também os originais, em particular para o formato PDF, permitindo a leitura diretamente no navegador. Além disso, o compactado desse formato vem com arquivos separados por seções da documentação (tutorial, referência da linguagem, referência da biblioteca...), gostaria de disponibilizar esses arquivos dessa forma. Normalmente, as pessoas estão interessadas em seções específicas e não em toda a documentação de uma vez.

Update: foi decidido pela não mais disponibilização dos PDFs.

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 lại trang tải xuống hiện tại tại docs.python.org/pt-br/3.13/download.html và cuộc thảo luận được liên kết trước khi xác định entry point của quá trình build tài liệu; issue không nêu tên tệp repository hoặc test nào. Công việc được xem là hoàn tất khi các định dạng có thể tải xuống đã thống nhất được tạo trên python.org.br với các archive được tách theo section, đồng thời tuân thủ quyết định về việc có cung cấp PDF hay không.

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

Đánh giá

Công nghệ
python
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
4/5
Thời gian dự kiến
3-5 ngày
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.