Skip to content

Configure Sphinx documentation and ReadTheDocs CI#2

Merged
trissim merged 2 commits intomasterfrom
claude/configure-sphinx-docs-ci-011CUhoChPtZt4YnCKB9Y4p8
Nov 1, 2025
Merged

Configure Sphinx documentation and ReadTheDocs CI#2
trissim merged 2 commits intomasterfrom
claude/configure-sphinx-docs-ci-011CUhoChPtZt4YnCKB9Y4p8

Conversation

@trissim
Copy link
Owner

@trissim trissim commented Nov 1, 2025

  • Add .readthedocs.yaml configuration for automatic docs building
  • Set up Sphinx documentation structure in docs/source/
    • conf.py with autodoc, napoleon, and RTD theme
    • index.rst with project overview
    • api/modules.rst for API reference documentation
  • Replace mkdocs with Sphinx dependencies in pyproject.toml
  • Add GitHub Actions workflow for docs building on push
  • Include Makefile and make.bat for local docs building
  • Add .gitignore to exclude build artifacts

The documentation will now be automatically built on ReadTheDocs on every push, similar to openhcs and metaclass-registry.

- Add .readthedocs.yaml configuration for automatic docs building
- Set up Sphinx documentation structure in docs/source/
  - conf.py with autodoc, napoleon, and RTD theme
  - index.rst with project overview
  - api/modules.rst for API reference documentation
- Replace mkdocs with Sphinx dependencies in pyproject.toml
- Add GitHub Actions workflow for docs building on push
- Include Makefile and make.bat for local docs building
- Add .gitignore to exclude build artifacts

The documentation will now be automatically built on ReadTheDocs
on every push, similar to openhcs and metaclass-registry.
@trissim
Copy link
Owner Author

trissim commented Nov 1, 2025

@copilot readthedocs build is failing in CI, pls fix

Copy link

Copilot AI commented Nov 1, 2025

@trissim I've opened a new pull request, #3, to work on those changes. Once the pull request is ready, I'll request review from you.

- Add .gitkeep files to _static and _templates directories
  so they are tracked by git and exist during CI builds
- Remove -W flag from main docs build step to prevent
  intersphinx network warnings from failing the build
- ReadTheDocs already has fail_on_warning: false configured
- CI will now succeed as long as docs build successfully
@trissim trissim merged commit 9fa6d1e into master Nov 1, 2025
15 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.

3 participants