Prover documentação para download

Aberta
#271 2 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
35/100
Tipo de issue
Documentação
Clareza
Razoavelmente clara
Status de atividade
Estagnada
Stack de tecnologia
python
Domínio
documentation

Direção de pesquisa

Revise a página de download atual em docs.python.org/pt-br/3.13/download.html e a discussão vinculada antes de localizar o ponto de entrada do build da documentação; a issue não nomeia arquivos do repositório nem testes. Considera-se concluído quando os formatos para download acordados forem gerados em python.org.br com arquivos separados por seção, respeitando a decisão sobre a disponibilidade de PDF.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.

Linguagem predominante
Python
Estrelas
164
Forks
42
Merge médio
14h 32min
PRs com merge (30d)
4

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de python/python-docs-pt-br

Todas as issues de python/python-docs-pt-br

Issues semelhantes

Mais issues de Python

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.