python / python/python-docs-pt-br

Prover documentação para download

Open
#271 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
164
Forks
42
Avg merge
14h 32m
Merged PRs (30d)
4

Description

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.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the current download page at docs.python.org/pt-br/3.13/download.html and the linked discussion before locating the documentation-build entry point; the issue names no repository files or tests. Done means the agreed downloadable formats are generated on python.org.br with section-separated archives, while respecting the decision about PDF availability.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.