Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add autoapi to crawl our modules and populate the docs, closes #14 #36

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

salomaestro
Copy link
Contributor

Uses the docstrings of our code to generate documentation.

Uses the docstrings of our code to generate documentation.
@salomaestro salomaestro changed the title Add autoapi to crawl our modules and populate the docs Add autoapi to crawl our modules and populate the docs, relates to #14 Feb 4, 2025
@salomaestro
Copy link
Contributor Author

salomaestro commented Feb 4, 2025

PS: If you want to work on this draft PR simultaneously, here is a quick guide:

git fetch origin pull/36/head:some-branch-name  # 36 is the number of the PR
git switch some-branch-name

...  # Make your changes to the code and commit them

git push origin christian/sphinx-autoapi

I think this should do it. It could be that instead of pushing to christian/sphinx-autoapi, you could also push to the PR with git push origin pull/36/head but I haven't tested that.

Also, remember that to host the documentation locally, run sphinx-autobuild doc _build.

Added a bit more information to some of the docstrings, but there is
still a lot of room for improvement ;)
@salomaestro salomaestro changed the title Add autoapi to crawl our modules and populate the docs, relates to #14 Add autoapi to crawl our modules and populate the docs, closes #14 Feb 4, 2025
@salomaestro salomaestro added the documentation Improvements or additions to documentation label Feb 4, 2025
@salomaestro salomaestro linked an issue Feb 4, 2025 that may be closed by this pull request
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hzavadil98 I took the liberty here to edit your docstring.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, I had copilot do it and didn't really check the result properly 🙈

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add autoapi to sphinx documentation
2 participants