Skip to content

chore: bump to 0.3.6, migrate docs to openlegalstandard.org#18

Merged
mjbommar merged 1 commit into
mainfrom
cleanup/docs-migration
Apr 8, 2026
Merged

chore: bump to 0.3.6, migrate docs to openlegalstandard.org#18
mjbommar merged 1 commit into
mainfrom
cleanup/docs-migration

Conversation

@mjbommar

@mjbommar mjbommar commented Apr 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Migrates user-facing documentation from the broken folio-python.readthedocs.io site to a comprehensive 9-page reference at openlegalstandard.org/resources/folio-python-library (alea-institute/openlegalstandard.org#1), then deletes the Sphinx infrastructure from this repo.

Closes #14.

Changes

Removed

  • docs/ (Sphinx project — replaced by Astro)
  • .readthedocs.yaml (RTD build config)
  • .github/workflows/publish.yml (Trusted Publisher workflow that was never wired up on PyPI; releases are published locally with uv build && uvx twine upload)

Moved

  • docs/_static/folio-logo.pngassets/folio-logo.png

Updated

  • README.md — Documentation section now points at openlegalstandard.org with a brief description of the new sub-pages; logo image path updated to match the moved asset
  • CONTRIBUTING.md — adds a Documentation section explaining where user-facing docs live and asking PRs that touch public API to keep them in sync

Version bump

  • pyproject.toml: 0.3.5 → 0.3.6
  • folio/__init__.py: 0.3.5 → 0.3.6
  • uv.lock self-reference: 0.3.5 → 0.3.6
  • CHANGES.md entry for 0.3.6

Test plan

  • uv sync — clean
  • uv run pytest tests/ -k "not benchmark" — 54/54 passing
  • uv run ruff check — clean
  • New documentation URL serves 200 (https://openlegalstandard.org/resources/folio-python-library — verified live before merge)
  • README image link points at the moved asset path
  • No broken internal references after the docs/ deletion (no module imports or tests reference docs/)

🤖 Generated with Claude Code

The user-facing documentation has moved from the broken
folio-python.readthedocs.io site to a comprehensive 9-page reference at
https://openlegalstandard.org/resources/folio-python-library/. The new
site covers install, search, structured queries, taxonomy, properties
and triples, serialization, LLM integration, and a full API reference,
with every code snippet validated against the published wheel.

This commit removes the now-redundant Sphinx infrastructure from the
folio-python repo:

- docs/                            (entire Sphinx project, replaced by Astro)
- .readthedocs.yaml                (RTD build config no longer needed)
- .github/workflows/publish.yml    (Trusted Publisher workflow that was
                                    never configured on PyPI; releases
                                    are published locally via
                                    `uv build && uvx twine upload`)

Logo moved from docs/_static/folio-logo.png to assets/folio-logo.png
and the README image link updated. README documentation link now
points at openlegalstandard.org. CONTRIBUTING.md adds a note that
user-facing docs live in the openlegalstandard.org repo and should be
updated alongside any public-API changes.

Version bumps:
- pyproject.toml: 0.3.5 -> 0.3.6
- folio/__init__.py: 0.3.5 -> 0.3.6
- uv.lock: self-reference 0.3.5 -> 0.3.6

Closes #14.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@mjbommar mjbommar merged commit b7c18e7 into main Apr 8, 2026
6 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.

Broken link to readthedocs

1 participant