lincc-frameworks / lincc-frameworks/python-project-template
Cleaner left-hand table-of-contents for API reference
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Jinja
- Sterne
- 85
- Forks
- 16
- Ø Merge
- 6 Std. 18 Min.
- Gemergte PRs (30 T.)
- 1
Beschreibung
Looking at the HATS RTD, the menu options in the left-hand-side for the API reference have a lot of unnecessary duplication:
```
API reference
└── hats
├── hats.catalog
├── hats.inspection
└── ...
```
I would really love if we could have it be simpler:
```
hats API reference
├── catalog
├── inspection
└── ...
```
this includes the package name in the top-level, and omits the package name from the submodule names.
I don't even know if sphinx/autoapi supports this, but I can dream, right?
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 damit, die Sphinx/AutoAPI-Konfiguration zu lokalisieren, die die API-Referenz in der Read the Docs-Dokumentation erzeugt. Prüfe, ob ihre Optionen den angeforderten Namen des Top-Level-Pakets und kürzere Bezeichnungen für Submodule erzeugen können. Erledigt ist die Aufgabe, wenn die gerenderte Navigation auf der linken Seite „hats API reference“ mit Einträgen wie „catalog“ und „inspection“ anzeigt, ohne wiederholte Paketnamen.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- documentation
- Issue-Typ
- Feature
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 38/100