From 5b4c0fc318009c9adb9ab3eca28c3a3c62f413a2 Mon Sep 17 00:00:00 2001
From: Sylwester Lachiewicz <slachiewicz@apache.org>
Date: Fri, 7 Aug 2026 11:41:11 +0200
Subject: [PATCH] Restore the document metadata dropped when the pages were
 ported

An APT document opens with a header block giving its title, authors and date, and
doxia-converter turns that into YAML front matter. The port removed the front
matter along with the converter's per-line licence comments, so the generated
pages lost their author and date meta tags, and took their title from the first
heading rather than from the document title.

The front matter has to come first in the file: the Markdown parser only looks for
it when the source begins with "---". A licence header ahead of it would hide it,
and RAT is happy either way.
---
 maven-plugin-annotations/src/site/markdown/index.md.vm    | 7 +++++++
 .../src/site/markdown/examples/generate-descriptor.md.vm  | 7 +++++++
 .../src/site/markdown/examples/generate-help.md.vm        | 7 +++++++
 .../src/site/markdown/examples/using-annotations.md.vm    | 7 +++++++
 maven-plugin-plugin/src/site/markdown/index.md            | 7 +++++++
 maven-plugin-plugin/src/site/markdown/usage.md            | 8 ++++++++
 .../src/site/markdown/examples/generate-report.md.vm      | 7 +++++++
 maven-plugin-report-plugin/src/site/markdown/index.md     | 7 +++++++
 maven-plugin-report-plugin/src/site/markdown/usage.md     | 8 ++++++++
 maven-plugin-tools-annotations/src/site/markdown/index.md | 7 +++++++
 maven-plugin-tools-api/src/site/markdown/index.md         | 7 +++++++
 11 files changed, 79 insertions(+)

diff --git a/maven-plugin-annotations/src/site/markdown/index.md.vm b/maven-plugin-annotations/src/site/markdown/index.md.vm
index 099151ff..09dcde4b 100644
--- a/maven-plugin-annotations/src/site/markdown/index.md.vm
+++ b/maven-plugin-annotations/src/site/markdown/index.md.vm
@@ -1,3 +1,10 @@
+---
+title: About ${project.name}
+author: 
+  - Hervé Boutemy
+date: 2012-06-03
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm b/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm
index d1e589e3..27c1af9f 100644
--- a/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm
+++ b/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm
@@ -1,3 +1,10 @@
+---
+title: Configuring Generation of Plugin Descriptor
+author: 
+  - Maria Odea Ching
+date: 2008-02-01
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm b/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm
index 49c0f10c..99890a47 100644
--- a/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm
+++ b/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm
@@ -1,3 +1,10 @@
+---
+title: Configuring Generation of Help Mojo
+author: 
+  - Vincent Siveton
+date: 2008-01-01
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm b/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm
index e20ed68b..93304071 100644
--- a/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm
+++ b/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm
@@ -1,3 +1,10 @@
+---
+title: Using Plugin Tools Java5 Annotations
+author: 
+  - Olivier Lamy
+date: 2012-05-14
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/index.md b/maven-plugin-plugin/src/site/markdown/index.md
index a29eb31c..0ea1f957 100644
--- a/maven-plugin-plugin/src/site/markdown/index.md
+++ b/maven-plugin-plugin/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author: 
+  - Maria Odea Ching
+date: 2008-01-01
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/usage.md b/maven-plugin-plugin/src/site/markdown/usage.md
index b13f77b9..6d2b594d 100644
--- a/maven-plugin-plugin/src/site/markdown/usage.md
+++ b/maven-plugin-plugin/src/site/markdown/usage.md
@@ -1,3 +1,11 @@
+---
+title: Usage
+author: 
+  - Maria Odea Ching
+  - Vincent Siveton
+date: 2008-01-01
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm b/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm
index bf19f313..d666bc67 100644
--- a/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm
+++ b/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm
@@ -1,3 +1,10 @@
+---
+title: Configuring Generation of Documentation Reports
+author: 
+  - Vincent Siveton
+date: 2008-01-01
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-report-plugin/src/site/markdown/index.md b/maven-plugin-report-plugin/src/site/markdown/index.md
index 67eb91ac..0b19f556 100644
--- a/maven-plugin-report-plugin/src/site/markdown/index.md
+++ b/maven-plugin-report-plugin/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author: 
+  - Maria Odea Ching
+date: 2008-01-01
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-report-plugin/src/site/markdown/usage.md b/maven-plugin-report-plugin/src/site/markdown/usage.md
index fa009b88..7bce8a3d 100644
--- a/maven-plugin-report-plugin/src/site/markdown/usage.md
+++ b/maven-plugin-report-plugin/src/site/markdown/usage.md
@@ -1,3 +1,11 @@
+---
+title: Usage
+author: 
+  - Maria Odea Ching
+  - Vincent Siveton
+date: 2008-01-01
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-tools-annotations/src/site/markdown/index.md b/maven-plugin-tools-annotations/src/site/markdown/index.md
index 83bbe3a6..ca686695 100644
--- a/maven-plugin-tools-annotations/src/site/markdown/index.md
+++ b/maven-plugin-tools-annotations/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author: 
+  - Hervé Boutemy
+date: 2012-05-12
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
diff --git a/maven-plugin-tools-api/src/site/markdown/index.md b/maven-plugin-tools-api/src/site/markdown/index.md
index a4d7188b..27606281 100644
--- a/maven-plugin-tools-api/src/site/markdown/index.md
+++ b/maven-plugin-tools-api/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author: 
+  - Vincent Siveton
+date: 2012-05-14
+---
+
 <!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file