)]}'
{
  "commit": "c169eb68a785ca820590f20003b47b0a605a9673",
  "tree": "2f5a57974abab39b33c738e11e15b2384d8140a2",
  "parents": [
    "ca413df397f5afdce55c9ed6feffc4b81e0d92f5"
  ],
  "author": {
    "name": "Sylwester Lachiewicz",
    "email": "slachiewicz@apache.org",
    "time": "Mon Aug 10 01:40:23 2026 +0200"
  },
  "committer": {
    "name": "Sylwester Lachiewicz",
    "email": "slachiewicz@apache.org",
    "time": "Mon Aug 10 02:35:59 2026 +0200"
  },
  "message": "Convert the FAQ from FML to Markdown\n\ndoxia-converter cannot target FML usefully - the questions come out as\nlink-reference syntax rather than headings, the [top] back-links become\nlinks to a nonexistent \u0027top\u0027 page, and the contents links lose their #\nanchors. The page is written out by hand instead.\n\nThe single anchor, #question1, is a valid XML name, so Doxia serves it\nunchanged and the \u003ca id\u003e written here matches the live URL exactly.\n\nVerified by building the site before and after and comparing the set of\nanchors the generated faq.html actually serves. Every anchor present\nbefore is still present after, and the \u003chead\u003e is byte-identical, so the\ntitle and metadata are unchanged.\n\nThis also fixes the backticks around \u0027archive\u0027. FML hands an \u003canswer\u003e\nbody to Doxia\u0027s XdocParser, which has no backtick handling, so the page\nhas been serving the characters verbatim since the Simplified Technical\nEnglish rewrite in #581. Now that the page is Markdown the backticks are\ncorrect and render as \u003ccode\u003e, which is what PR #582 set out to achieve\nwith \u003ccode\u003e markup - that PR becomes unnecessary if this is merged. The\nfull stop that split \"defined by the Maven Archiver library, not by the\nMaven JAR Plugin\" into a sentence and a fragment is corrected here too,\nsince it came from the same rewrite.\n\nsite.xml needs no edit: src/site/fml/faq.fml and\nsrc/site/markdown/faq.md both render to faq.html, so the menu entry and\nthe link from index.md keep working.\n\nFML generates a [top] back-link after each answer; those are dropped\nrather than hand-written. The question becomes an h3 heading instead of\na definition term. Nothing else on the page changes.\n\nThe anchors are written as \u003ca id\u003d\"...\"\u003e, not \u003ca name\u003d\"...\"\u003e.\nmaven-site-plugin 3.21.0 strips the name attribute from inline HTML, which\nwould silently delete every anchor on the page while the build stays green;\n3.22.0 keeps it. Xhtml5BaseParser reads Attribute.ID first and only falls\nback to NAME, so id\u003d is the primary path rather than a workaround, and name\non \u003ca\u003e is obsolete in HTML5. Each anchor is kept on its own line: folding one\ninto the heading text suppresses the section\u0027s own generated id.\n\nGenerated-by: Claude Opus 5 (1M context)\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "ebe11990278f6ac3e8f46a1fc80f083bf514b14d",
      "old_mode": 33188,
      "old_path": "src/site/markdown/faq.md",
      "new_id": "bd6323099e7aa76fa9f105a38fa0334053cc2a13",
      "new_mode": 33188,
      "new_path": "src/site/markdown/faq.md"
    }
  ]
}