Prover documentação para download

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

Dieses Issue hat noch niemand übernommen.

Bewertung

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

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.

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.

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

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus python/python-docs-pt-br

Alle Issues in python/python-docs-pt-br

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

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