python / python/python-docs-pt-br

Prover documentação para download

Offen
#271 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
Python
Sterne
164
Forks
42
Ø Merge
14 Std. 32 Min.
Gemergte PRs (30 T.)
4

Beschreibung

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.

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Überprüfe zunächst die aktuelle Download-Seite unter docs.python.org/pt-br/3.13/download.html und die verlinkte Diskussion, bevor du den Einstiegspunkt für den Dokumentations-Build suchst; das Issue nennt keine Repository-Dateien oder Tests. Als erledigt gilt die Aufgabe, wenn die vereinbarten herunterladbaren Formate auf python.org.br mit nach Abschnitten getrennten Archiven generiert werden und dabei die Entscheidung über die Verfügbarkeit von PDF berücksichtigt wird.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.