Skip to content

docs: add mkdocstrings setup with example API reference#6

Merged
TaiSakuma merged 1 commit intomainfrom
mkdocstrings
Mar 18, 2026
Merged

docs: add mkdocstrings setup with example API reference#6
TaiSakuma merged 1 commit intomainfrom
mkdocstrings

Conversation

@TaiSakuma
Copy link
Owner

Summary

  • Add mkdocstrings configuration to zensical.toml with auto-style docstring detection (NumPy default)
  • Add mkdocstrings-python dependency to pyproject.toml
  • Create example math module with Numpydoc-style docstrings (add, fibonacci)
  • Add API Reference page (docs/api.md) and nav entry
  • Add "Docstrings" section to CONTRIBUTING.md with links to mkdocstrings and Numpydoc style guide

Test plan

  • Run uv run --group docs zensical serve and verify the API Reference page renders correctly
  • Confirm add and fibonacci docstrings display with parameters, returns, raises, and examples sections

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 18, 2026
@TaiSakuma TaiSakuma merged commit 5309c59 into main Mar 18, 2026
2 checks passed
@TaiSakuma TaiSakuma deleted the mkdocstrings branch March 18, 2026 11:28
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.

1 participant