Skip to content

Add Great Docs documentation site#44

Merged
cak merged 5 commits into
mainfrom
feat/add-great-docs
Jun 7, 2026
Merged

Add Great Docs documentation site#44
cak merged 5 commits into
mainfrom
feat/add-great-docs

Conversation

@cak
Copy link
Copy Markdown
Member

@cak cak commented Jun 7, 2026

Summary

Adds a Great Docs documentation setup for secure.

This PR introduces:

  • great-docs.yml for generated API documentation
  • a GitHub Actions workflow to build docs on PRs and publish docs from main
  • GitHub Pages deployment support
  • Great Docs build artifacts in .gitignore
  • a uv dev dependency for great-docs, limited to Python 3.11+

Details

The generated documentation configuration includes:

  • NumPy-style docstring parsing
  • author metadata
  • explicit API reference organization for the public classes and methods
  • canonical docs URL set to https://typeerror.com/secure/
  • Jupyter kernel configuration for .qmd support

The docs workflow builds the site with Python 3.11, installs Great Docs, runs great-docs build, stores the generated HTML as an artifact, and deploys to GitHub Pages on pushes to main.

Notes

secure still supports Python 3.10+. Since Great Docs requires Python 3.11+, the dev dependency is guarded with a Python version marker so documentation tooling does not raise the package runtime requirement.

Comment thread .github/workflows/docs.yml Fixed
…ntain permissions'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
@cak cak merged commit 5878d0d into main Jun 7, 2026
11 checks passed
@cak cak deleted the feat/add-great-docs branch June 7, 2026 16:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants