)]}'
{
  "commit": "b1510d026c794afda124c3c96214664e874a0e58",
  "tree": "cce6d8a0e0e2ba5761885d0e0ee5029693062731",
  "parents": [
    "cf9a0f9b16ff73042324ffc42c598766e6226825"
  ],
  "author": {
    "name": "Sylwester Lachiewicz",
    "email": "slachiewicz@apache.org",
    "time": "Mon Aug 10 01:50:39 2026 +0200"
  },
  "committer": {
    "name": "Sylwester Lachiewicz",
    "email": "slachiewicz@apache.org",
    "time": "Mon Aug 10 03:16:18 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 page stays a Velocity template: the two sample POMs interpolate\n${project.version}, which renders as the current plugin version. In a\n.vm file an ATX heading starting \u0027##\u0027 is swallowed as a Velocity line\ncomment, so the title uses a setext underline and each question is\nwrapped in #[[### ... ]]# to reach the renderer intact.\n\nExplicit anchors keep the existing deep links working. The \u003ca id\u003e\nemitted here reproduces the anchor the rendered page serves today, not\nthe raw \u003cfaq id\u003e attribute.\n\nAnchors are written as \u003ca id\u003e, not \u003ca name\u003e: maven-site-plugin\n3.21.0 strips name\u003d from an inline HTML anchor, which loses every anchor\non an otherwise green build, and name\u003d on \u003ca\u003e is obsolete in HTML5.\nXhtml5BaseParser reads Attribute.ID first and only falls back to NAME,\nso id\u003d is the primary path. Each anchor sits on its own line, since\nfolding one into the heading text suppresses the section\u0027s own id.\n\nStraight quotes in prose are written as \u0026quot; and \u0026apos;. flexmark\u0027s\nsmart-punctuation extension would otherwise turn them into typographic\nquotes, silently changing the visible text - FML, being XML, rendered\nthem straight. This is the convention maven-site-plugin\u0027s own converted\npages already use.\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:\n\n  before: filtering, classifieruse, transitiveexclude,\n          dependentwarexclude, webresourcesexclude, waroverlaysexclude,\n          configurationdoc, attached, top, bodyColumn\n  after:  the same ten, plus nine heading-derived ids\n\nThe check also compares the visible text of the two pages word by word;\nit is identical apart from the dropped [top] links. The site log reports\nno \"used more than once\" anchor warning.\n\nThe \u003chead\u003e is byte-identical, so the title and metadata are unchanged.\nsite.xml needs no edit - src/site/fml/faq.fml.vm and\nsrc/site/markdown/faq.md.vm both render to faq.html.\n\nFML generates a [top] back-link after each answer; those are dropped\nrather than hand-written. The question now renders as an h3 heading\ninstead of a definition term. Those are the only rendering losses.\n\nGenerated-by: Claude Opus 5 (1M context)\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "19fc6f81c5da222e3f95152e2d24404f089d1cab",
      "old_mode": 33188,
      "old_path": "src/site/markdown/faq.md.vm",
      "new_id": "c9db84590262203977eed70fbb5fd850cdd621a6",
      "new_mode": 33188,
      "new_path": "src/site/markdown/faq.md.vm"
    }
  ]
}