python / python/editorial-board

For readers -- fix the doc links on python.org

Aperta
#1 1 commento 3 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

readers
Lingua principale
HTML
Stelle
14
Fork
1
Merge medio
59m
PR unite (30g)
2

Descrizione

The documentation tab on python.org is not very friendly:

Screenshot 2024-01-08 at 17 20 16

Several links take you to this useless interstitial page: https://www.python.org/doc/ -- instead the tab should take you directly to https://docs.python.org/3/, or at the very least it should have a bold yellow button that takes you there (rather than a gray one).

Some other materials are seriously outdated or limited; the A/V link goes to a page with mostly outdated podcasts, for example (the list of recent PyCon talks is at the bottom). The Beginners link goes to a wiki page. Etc., etc.

  • Link to discussion about the proposal (Discourse or GitHub): not yet

See also: https://docs.google.com/presentation/d/1ujDv8wViPvAMFAtYCRxSKh-CMUlbjcfVYitsqEI2Ios/edit#slide=id.p

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia esaminando la scheda della documentazione e i link descritti in questa issue, in particolare /doc/ e https://docs.python.org/3/. Esamina la presentazione collegata e le destinazioni A/V e Beginners. Il lavoro è completato quando la scheda porta direttamente alla documentazione corrente e i materiali identificati come obsoleti o limitati hanno link sostitutivi concordati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
html
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
3/5
Tempo stimato
1-2 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
42/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.