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

Docstrings and API docs #176

Merged
merged 34 commits into from
Sep 9, 2024
Merged

Docstrings and API docs #176

merged 34 commits into from
Sep 9, 2024

Conversation

SpectralVectors
Copy link
Collaborator

Docstrings and API docs site

Added docstrings to functions to help explain what the function does, what arguments it takes, and to lay the foundation for API docs.
e.g.

def function(a, b):
"""function takes two floats and multiplies them.

    Args
        a (float) The first float value
        b (float) The second float value
    Returns
        result (float) The result of the multiplication operation.
"""

Then added and streamlined a Github workflow to auto-build and host the API documentation site on Github Pages.

Preview

API Docs

NOTE

You must enable Github Pages, and set it to build from the branch 'gh-pages' '(root)'.
This branch will be automatically created the first time the workflow runs, so you will need to let it run once, then go into the repository settings, enable Pages, and set it to build from the gh-pages branch.

@pppalain pppalain merged commit 02ee343 into pppalain:master Sep 9, 2024
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants