Migration report: manifest-help.ditamap

MANIFEST 1.1.0 · DITA-OT 4.4.0 · Sphinx 9.2.0 · MyST-Parser 5.1.0 · lychee 0.24.2 · builds: unfiltered

✓ Pass gate 2 topic(s) need a writer; 0 fixed by a rule awaiting approval; 0 failed.

29topics
27passed, no writer needed
0fixed by a proposed rule
2sent to a writer
0failed a check
1builds compared with DITA-OT

Topics

Each check compares DITA-OT HTML5 of the source with Sphinx of the migrated MyST, in every build. A difference is listed under its topic.
TopicStatusCountsText IDsLinksNote
topics/gs-overview.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 include(s), 4 substitution(s) restored
topics/gs-first-migration.dita◇ Review✓ Pass✓ Pass✓ Pass✓ Pass2 substitution(s) restored; <xref> line 10: needs a writer
topics/t-migrate-your-dita.dita◇ Review✓ Pass✓ Pass✓ Pass✓ Pass1 substitution(s) restored; <xref> line 12: needs a writer
topics/c-fidelity.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass2 substitution(s) restored
topics/c-reuse-ledger.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 substitution(s) restored
topics/c-placeholders.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 substitution(s) restored
topics/c-mapping-rules.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 include(s) restored
topics/c-hitl.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass2 substitution(s) restored
topics/t-sign-in.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/t-run-migration.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass2 include(s), 1 substitution(s) restored
topics/t-read-run.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/t-review-failed-topic.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/t-approve-fix.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 include(s) restored
topics/t-add-github-action.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 substitution(s) restored
topics/t-rollback.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/r-checks.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/r-report-schema.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/r-cli.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass2 substitution(s) restored
topics/r-api.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/r-configuration.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 substitution(s) restored
topics/r-glossary.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass1 substitution(s) restored
topics/ts-text.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/ts-structure.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/ts-ids.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/ts-pages.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/ts-review.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/ts-run-failed.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ PassNo reuse
topics/rn-1-0-0.dita✓ Pass✓ Pass✓ Pass✓ Pass✓ Pass5 substitution(s) restored

Review items

Source elements MANIFEST has no rule for. Each one is sent to a writer (US-03); none is dropped silently.
TopicElement LineWhy
topics/gs-first-migration.dita<xref>10keyref on <xref> with content or as a link: no mapping rule yet
topics/t-migrate-your-dita.dita<xref>12keyref on <xref> with content or as a link: no mapping rule yet

Findings in the source

Things the migration kept as they are, but a writer should know. Details for each occurrence are in report.json.
Finding CountWhat to doTopics
possible-typed-copy1A value typed in the source equals a key's value. If it means the same thing, replace it with the key, so the value is changed in one place. Each place is listed in report.json.topics/r-api.dita

Success metrics

Design doc §7, measured on this run.
MetricTargetMeasuredHow
Unreported losses00Every difference the checks find is listed in this report (0 this run). Losses found after merge are tracked against it.
Topics checked100%100%29 of 29 topics, 29 comparisons across 1 builds
Reuse kept100% of mapped features93%5/5 conrefs as includes or substitutions; 22/24 key references as substitutions
IDs kept100%100%36/36 published IDs are anchors in DITA-OT's form; 7 old anchors resolve across all builds
Broken links00lychee 0.24.2 offline: 1401 links; 29 old URLs; navigation compared with DITA-OT
Topics passed without a writerSet from the first run27/29Topics with no difference and no review item
Fixes approvedTracked1 approvedApproved rules applied: table-title-to-paragraph. No agent ran (`manifest migrate`).

— checked, not assumed