python / python/python-docs-pt-br
Prover documentação para download
Ninguém assumiu esta issue ainda.
- Linguagem predominante
- Python
- Estrelas
- 164
- Forks
- 42
- Merge médio
- 14h 32min
- PRs com merge (30d)
- 4
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.
Guia de contribuição
Nenhum guia de contribuição indexado para este repositório
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
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.
Avaliação
- Stack de tecnologia
- python
- Domínio
- documentation
- Tipo de issue
- Documentação
- Dificuldade
- 4/5
- Tempo estimado
- 3-5 dias
- Status de atividade
- Estagnada
- Clareza
- Razoavelmente clara
- Facilidade para iniciantes
- 35/100