Convert the remaining xdoc pages to Markdown - #24
Merged
Conversation
Git's rename detection is similarity-based, so a rename and a rewrite in one commit is recorded as a delete plus an add and git log --follow stops there. Please merge or rebase rather than squash. Generated-by: Claude Opus 5 (1M context)
get-involved and ref/available-components, converted with doxia-converter. The YAML front matter is kept: it carries each page's title and author, which the skin turns into <title> and <meta name="author">. 404.xml stays xdoc on purpose. It carries a <head> block with a <base href> and absolute stylesheet links, and Markdown front matter can only produce <title> and <meta>; a 404 page is served from arbitrary URLs, so the <base> cannot be dropped. Verified by rendering the site before and after: both pages are identical in title, author, visible text and every link target. Generated-by: Claude Opus 5 (1M context)
slachiewicz
added
documentation
slachiewicz
marked this pull request as ready for review
August 9, 2026 17:15
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Converts the two remaining hand-written xdoc pages to Markdown with
doxia-converter:get-involved.xmlandref/available-components.xml.Please merge or rebase rather than squash — the rename is in its own commit so
git log --followkeeps working, and squashing collapses it back into a delete plus an add.404.xmldeliberately stays xdoc. It carries a<head>block with<base href>plus absolute stylesheet and script links, and Doxia's Markdown parser turns front matter into only<title>and<meta>— there is no way to emit<base>,<link>or<script>from Markdown. A 404 page is served from arbitrary URLs, so that<base>cannot be dropped.Verification
The site was rendered before and after and the two pages compared on title, author, visible text and link targets: identical, both of them.
The YAML front matter is kept and must stay the first bytes of each file: it carries the title and author, and without it the parser falls back to the first heading and
<meta name="author">disappears. Plexus parent 26 already excludes**/src/site/markdown/**from spotless's flexmark formatter, which would otherwise rewrite the fence closing the front matter.