slachiewicz opened a new pull request, #1354: URL: https://github.com/apache/maven-assembly-plugin/pull/1354
Part of an estate-wide move of the remaining FAQ pages from FML to Markdown. This repo is one of three pilots. ### Two commits, deliberately 1. **A pure rename**, `src/site/fml/faq.fml` -> `src/site/markdown/faq.md`, no content change. 2. **The rewrite**, written by hand. Git records a rename plus a rewrite in a single commit as a delete and an add, which stops `git log --follow`. Splitting them keeps the history. **Please merge or rebase rather than squash.** ### Anchors are preserved, and that is the point These pages have been on maven.apache.org for years and are linked from outside. FML derives its anchor from the `<faq id=...>` attribute, and where that attribute is not a valid XML name `DoxiaUtils.encodeId` rewrites it at render time. The `<a name>` elements written here reproduce **the anchor the live site serves today**, not the raw attribute. ### Verification Built the site before and after and compared the set of anchors the generated `faq.html` actually serves. Requirement: every anchor served before must still be served after. ### What is lost FML generates a `[top]` back-link after each answer. Those are dropped rather than hand-written. The question becomes an `h3` heading instead of a definition term. Nothing else changes. <sub>Drafted with Claude — please verify</sub> **This repo:** all 10 anchors are semantic ids used verbatim (`#deploy`, `#classifier`, `#javadoc`, `#inherit`, `#shared-descriptor-bug`, `#module-binaries`, `#required-classifiers`, `#dashClassifier`, `#outputFileNameMapping`, `#tarFileModes`). All preserved; `<head>` byte-identical. One extra note: the sharing-descriptors link in the `shared-descriptor-bug` question appeared twice before, because FML repeats the question in the contents list and thereby nested an `<a>` inside the contents entry's own `<a>` — invalid HTML that browsers do not make clickable. The contents entry now carries plain question text and the link stays in the heading, where it works. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
