You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/08/10 01:11:07 UTC

(maven-enforcer) branch master updated: Use rather than for the FAQ anchors

This is an automated email from the ASF dual-hosted git repository.

slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-enforcer.git


The following commit(s) were added to refs/heads/master by this push:
     new 09213e3e Use <a id> rather than <a name> for the FAQ anchors
09213e3e is described below

commit 09213e3eb20837e4c521dc8171dd8c62d795a313
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 02:29:48 2026 +0200

    Use <a id> rather than <a name> for the FAQ anchors
    
    maven-site-plugin 3.21.0 drops the name attribute from inline HTML
    anchors while 3.22.0 keeps it, so a page written with <a name> loses its
    anchors on the older plugin with a green build and no warning. Doxia's
    Xhtml5BaseParser reads Attribute.ID first and only falls back to NAME, so
    id is the primary path; name on <a> is also obsolete in HTML5.
    
    This project builds with 3.22.0 today, so the published anchors are not
    currently affected. The change makes the page correct on both, and keeps
    it correct if it is ever back-ported to a line with an older toolchain.
    It also aligns this FAQ with the rest of the estate-wide FML to Markdown
    conversion, which now uses <a id> throughout.
    
    Verified by generating the site and comparing the anchors the generated
    faq.html serves. Unchanged: question and top are both still served, the
    <head> is byte-identical, and the build emits no duplicate-anchor
    warning.
    
    Generated-by: Claude Opus 5 (1M context)
---
 maven-enforcer-plugin/src/site/markdown/faq.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/maven-enforcer-plugin/src/site/markdown/faq.md b/maven-enforcer-plugin/src/site/markdown/faq.md
index e6094dca..9bc5ce64 100644
--- a/maven-enforcer-plugin/src/site/markdown/faq.md
+++ b/maven-enforcer-plugin/src/site/markdown/faq.md
@@ -21,13 +21,13 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-<a name="top"></a>
+<a id="top"></a>
 
 # Frequently Asked Questions
 
 1. [Why can't I just use the prerequisites tag in the pom?](#question)
 
-<a name="question"></a>
+<a id="question"></a>
 
 ### Why can't I just use the prerequisites tag in the pom?