Markover docs User guide

Reference

Review format compatibility

This is Markover's official mapping from a review artifact's format and version header to the application release that understands it.

Current catalog

ArtifactVersionFirst compatible release
markover-review1Not yet assigned; development under issue #99

The first release carrying portable v1 must replace the pending entry before publication. Later releases update this table whenever they introduce a review-format version.

Tools can read the same information from the machine-readable catalog.

If your Markover reports an unknown version

Do not edit or reinterpret the review JSON. Match its header to this catalog and install the listed Markover release. If no entry exists, update Markover and keep the artifact untouched while asking for support.

Markover keeps incompatible review JSON and attachments in place. A future-version diagnostic uses only the header and does not guess at the body.

Older released versions

When a released review schema needs conversion, a supporting Markover release migrates it automatically on load. It first preserves a byte-for-byte backup of the original review directory, validates a separate converted copy, and replaces the active artifact only after validation succeeds.

Unreleased prototype shapes are not compatibility targets.