Mintlify compatibility

[b-Tomas]

Description

Reduce the docs to common syntax for Sphinx and Mintlify, enabling a mintlify mutlirepo while maintaining the Sphinx site.

See inorbit-ai/docs#1

---

Note

Ports docs to shared Markdown content for Sphinx and Mintlify, adds Mintlify builder/navigation, restructures Sphinx, and updates CI to build from the new path.

• Documentation:
  • Portable content: New shared docs under docs/contents using YAML frontmatter; internal links converted to Markdown links.
  • Sphinx restructure: Source moved to docs/sphinx with wrapper pages that {include} shared content; conf.py reads version without importing, updates static paths, sets root_doc, and suppresses MyST anchor warnings; Makefile gains serve target.
• Mintlify:
  • Navigation: Adds docs/contents/docs.json for site navigation.
  • Build tooling: Adds docs/mintlify/build.py and Makefile to emit Mintlify-compatible output with absolute routes.
• CI/CD:
  • Pages workflow: sphinx-build path switched to docs/sphinx and artifact path updated to docs/sphinx/_build/html in .github/workflows/docs.yaml.
• Repo housekeeping:
  • .gitignore updated to ignore docs/*/_build/.
  • REUSE.toml extended to annotate new docs and build files.
  • CONTRIBUTING.md updated with new build/serve paths and commands.

^{Written by Cursor Bugbot for commit bd43c2d. This will update automatically on new commits. Configure here.}