Documentation empty for model_repository, reports, report_images

Offen
#175 1 Kommentar 0 Reaktionen 1 zugewiesene Person Auf GitHub ansehen

@smlindauer arbeitet bereits daran.

Seit 17.7.2023.

Bewertung

Dieses Issue wurde noch nicht bewertet.

Beschreibung

question

The API documentation for the model_repository, reports & report_images services seems to be missing:
https://sassoftware.github.io/python-sasctl/api/services/model_repository.html
https://sassoftware.github.io/python-sasctl/api/services/report_images.html
https://sassoftware.github.io/python-sasctl/api/services/reports.html

In the case of the model_repository service, the docstring on line 7 in services/model_repository.py is still read but not the rest of the code.

I tried cloning this repo to build the documentation using: tox -e py38-doc but sphinx returned the error:
Extension error:
Could not import extension numpydoc (exception: No module named 'numpydoc')
Changing from numpydoc to napoleon then returned:
Theme error:
no theme named 'pydata_sphinx_theme' found (missing theme.conf?)

Even installing both of the above packages with pip install failed to resolve these sphinx errors.

In addition to understanding why the docs are missing it would be good to get assistance in resolving the above sphinx errors,

Thank you!

Vorherrschende Sprache
Python
Sterne
52
Forks
45
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Entwicklungsumgebung

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 sassoftware/python-sasctl

Alle Issues in sassoftware/python-sasctl

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

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