[vagenas]

Summary

Release 0.9.0: whitespace handling (#205), migrating to newer versions (#207), a source version option (#219) and archives (#220) in doclang migrate, <content> in <field_heading> (#212), semantic elements in markers (#222), and fixes.

Prepared with uv run python utils/prepare_release.py 0.9.0:

• Version 0.9.0 in pyproject.toml, the XSD, the spec.md Version: line and the versioned test fixture.
• The head schemas are snapshotted to doclang/schemas/0.9/ (identical to doclang/doclang.{xsd,sch}), so 0.7, 0.8 and 0.9 are bundled.
• doclang/migration/_steps/to_next.py and from_next.py are renamed to v0_8_to_0_9.py and v0_9_to_0_8.py, and fresh empty ones are created. The tests importing them now import the released steps.
• The Reference in spec.md is regenerated (no change beyond the version line) and exports/doclang.docx and exports/doclang-styled.docx are regenerated.
• CHANGELOG.md has a v0.9.0 section, one line per PR (change headings capitalization from title case to sentence case #181 to make tests survive a release #223).

By hand:

• CHANGELOG.md: a BREAKING CHANGE note under define whitespace handling #205 (interpretation of whitespace in raw text outside <content> now prescribed by spec).
• exports/: tables of contents updated in Word, and exports/doclang.pdf exported.
• uv.lock: only the doclang version line. uv lock cannot resolve: docling-core, a CI dependency through docling-slim, requires doclang<0.9. To be fixed separately.

Before merging

• make tests survive a release #223 is merged, and this branch is rebased onto main
• Check the changelog: the v0.9.0 entries in CHANGELOG.md match the merged PR titles and numbers, and include everything merged to main since v0.8.0 (v0.8.1 was released from release/0.8.x)
• Update the table of contents in exports/doclang.docx and exports/doclang-styled.docx in Word
• Export the PDF (exports/doclang.pdf)

After merging

• Tag the merge commit v0.9.0
• GitHub release and PyPI upload

Verified

• Full test suite (632 passed, 6 skipped as expected after a release), ruff and mypy.
• uv build: wheel and sdist 0.9.0, with schemas/0.9/ and both released steps; twine check passes.

[lehors]

@vagenas you really should merge PR #225 before merging this PR.

[vagenas]

@lehors thanks for the pointer, shared some feedback on that PR. Won't hold this release for that, but will certainly be part of the next one!