Skip to content

docs: convert remaining prose .rst to MyST .md (pass 2)#1249

Merged
Jammy2211 merged 1 commit intomainfrom
feature/rst-to-myst-md-pass2
May 4, 2026
Merged

docs: convert remaining prose .rst to MyST .md (pass 2)#1249
Jammy2211 merged 1 commit intomainfrom
feature/rst-to-myst-md-pass2

Conversation

@Jammy2211
Copy link
Copy Markdown
Collaborator

Summary

Continues the rst→md migration started in #1245. Converts:

  • Root README.rst (rewritten to plain CommonMark with inline badge links so it renders on GitHub and PyPI)
  • CITATIONS.rst
  • autofit/config/.../README.rst
  • test_autofit/config/non_linear/README.rst

Plus infra:

  • pyproject.toml: readme content-type → text/markdown
  • MANIFEST.in: ships README.md and CITATIONS.md

The workspace prose references in docs/general/{configs,workspace}.md intentionally still say "README.rst" — they point at the autofit_workspace README which is not being converted in this pass.

Test plan

  • CI green (unit tests + url_check)
  • PyPI long_description renders correctly under text/markdown

🤖 Generated with Claude Code

Continues the rst→md migration started in #1245. Converts:

- README.rst (rewritten as plain CommonMark with inline badge links so
  it renders correctly on GitHub and PyPI as well as inside Sphinx;
  rst-to-myst's MyST-with-substitutions output renders as literal text
  on GitHub and PyPI)
- CITATIONS.rst
- 4× autofit/config/.../README.rst
- test_autofit/config/non_linear/README.rst

Plus infra:
- pyproject.toml: readme content-type → text/markdown
- MANIFEST.in: include README.md / CITATIONS.md

The workspace prose references in docs/general/{configs,workspace}.md
intentionally still say "README.rst" — they point at the autofit_workspace
README which is not being converted in this pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@Jammy2211 Jammy2211 merged commit 981e15e into main May 4, 2026
3 checks passed
@Jammy2211 Jammy2211 deleted the feature/rst-to-myst-md-pass2 branch May 4, 2026 18:10
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.

1 participant