Skip to content

Add mkdocs documentation - #3

Merged
aarmey merged 4 commits into
mainfrom
add-mkdocs
Sep 1, 2026
Merged

Add mkdocs documentation#3
aarmey merged 4 commits into
mainfrom
add-mkdocs

Conversation

@aarmey

@aarmey aarmey commented Sep 1, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds an mkdocs-material site with API reference pages (mkdocstrings) for every public module (resample, procedures, seeds, store, query, uq, optimism)
  • Adds docs dependency group to pyproject.toml (mkdocs, mkdocs-material, mkdocstrings[python])
  • Matches the docs setup used across other meyer-lab Python repos (RISE, DDMC, parafac2)

No GitHub Pages deploy workflow is included here — the org's standard test/lint action is being added in a separate PR.

Test plan

  • uv sync --group docs
  • uv run mkdocs build --strict succeeds with no warnings/errors

🤖 Generated with Claude Code

https://claude.ai/code/session_01DCdnqsvzruAac1NCN9Thic

Adds an mkdocs-material site with an API reference (mkdocstrings) for
every public module, matching the docs setup used across other
meyer-lab Python repos (RISE, DDMC, parafac2).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DCdnqsvzruAac1NCN9Thic
@aarmey aarmey mentioned this pull request Sep 1, 2026
4 tasks
Builds the mkdocs site on push to main and uploads it as a Pages
artifact (actions/upload-pages-artifact + deploy-pages), not a
gh-pages branch, matching the pattern used by RISE/DDMC/parafac2.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DCdnqsvzruAac1NCN9Thic
@aarmey

aarmey commented Sep 1, 2026

Copy link
Copy Markdown
Member Author

@copilot resolve the merge conflicts in this pull request

Copilot AI and others added 2 commits September 1, 2026 21:08
# Conflicts:
#	pyproject.toml
#	uv.lock

Co-authored-by: aarmey <2065146+aarmey@users.noreply.github.com>
Co-authored-by: aarmey <2065146+aarmey@users.noreply.github.com>

Copilot AI commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Resolved in fae4451; 798bb92 additionally restricts the merged test workflow's token permissions.

@aarmey
aarmey merged commit 1b0b97f into main Sep 1, 2026
2 checks passed
@aarmey
aarmey deleted the add-mkdocs branch September 1, 2026 22:32
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