Typing spec: Improve cross-linking
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 1.8k
- Forks
- 302
- Ø Merge
- 23 Std.
- Gemergte PRs (30 T.)
- 8
Beschreibung
We should improve links within the spec. Concretely:
- Replace links to PEPs with links to the relevant part of the spec (https://github.com/python/typing/pull/1517#pullrequestreview-1763857938)
- Where we mention a feature, link it to the relevant spec section (e.g., whenever we mention
Annotated, it should link to the spec section that describesAnnotated). - Strategically add link targets so other Sphinx docs (e.g., docs.python.org, the PEPs) can link to the spec
This can be done in small increments, one PR at a time, and doesn't need signoff from the Typing Council. Contributions are welcome.
Beitragsleitfaden
Für dieses Repository ist kein Beitragsleitfaden indexiert
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit der Prüfung der verlinkten typing spec, insbesondere der Seite zum Typsystem und des referenzierten pull request. Identifiziere eine kleine Gruppe von PEP- oder Feature-Referenzen, die aktualisiert werden sollen, und überprüfe anschließend, dass relevante Spec-Abschnitte verlinkt sind und dass alle hinzugefügten Linkziele in der generierten Dokumentation korrekt aufgelöst werden.
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
- 42/100