From 7c194c7411a7b5161ccd2d28bedacf2a195a3217 Mon Sep 17 00:00:00 2001
From: Sylwester Lachiewicz <slachiewicz@apache.org>
Date: Thu, 6 Aug 2026 19:44:56 +0200
Subject: [PATCH 1/2] Rename the site documents ahead of converting them

A pure rename, so that git records it and `git log --follow` and `git blame` still
reach the history of each page after the conversion that follows. The content is
still APT at this point and the site does not build between the two commits.
---
 src/site/{apt/index.apt.vm => markdown/index.md} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename src/site/{apt/index.apt.vm => markdown/index.md} (100%)

diff --git a/src/site/apt/index.apt.vm b/src/site/markdown/index.md
similarity index 100%
rename from src/site/apt/index.apt.vm
rename to src/site/markdown/index.md

From 108ffa7ad078f2ee2cf763800c4a953e6ec02e84 Mon Sep 17 00:00:00 2001
From: Sylwester Lachiewicz <slachiewicz@apache.org>
Date: Thu, 6 Aug 2026 19:44:56 +0200
Subject: [PATCH 2/2] Port the index page from APT to Markdown

Converted with doxia-converter and then cleaned up by hand:

- <<<code>>> becomes backticks, <<bold>> becomes **bold**, {{{url}text}}
  becomes [text](url)
- the ASF license header becomes a single block HTML comment
- the page needs no Velocity, so it is a plain .md and the title, which was
  ${project.name}, is now spelled out

Verified by building the site before and after: the rendered page is
unchanged apart from <b>/<i> becoming <strong>/<em> and quotes in prose
picking up the Markdown module's typographic substitution.
---
 src/site/markdown/index.md | 47 +++++++++++++++-----------------------
 1 file changed, 19 insertions(+), 28 deletions(-)

diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index 23b98ef..eb2a086 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,33 +1,24 @@
- -----
- Introduction
- -----
- Hervé Boutemy
- -----
- 2013-07-23
- -----
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
 
- ~~ Licensed to the Apache Software Foundation (ASF) under one
- ~~ or more contributor license agreements.  See the NOTICE file
- ~~ distributed with this work for additional information
- ~~ regarding copyright ownership.  The ASF licenses this file
- ~~ to you under the Apache License, Version 2.0 (the
- ~~ "License"); you may not use this file except in compliance
- ~~ with the License.  You may obtain a copy of the License at
- ~~
- ~~   http://www.apache.org/licenses/LICENSE-2.0
- ~~
- ~~ Unless required by applicable law or agreed to in writing,
- ~~ software distributed under the License is distributed on an
- ~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~~ KIND, either express or implied.  See the License for the
- ~~ specific language governing permissions and limitations
- ~~ under the License.
+http://www.apache.org/licenses/LICENSE-2.0
 
- ~~ NOTE: For help with the syntax of this file, see:
- ~~ http://maven.apache.org/doxia/references/apt-format.html
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
 
-${project.name}
+# Apache Maven Dependency Tree
 
-  A tree-based API for resolution of Maven project dependencies.
+A tree-based API for resolution of Maven project dependencies.
 
-  Component entry point is <<<{{{./apidocs/org/apache/maven/shared/dependency/graph/DependencyGraphBuilder.html}DependencyGraphBuilder}}>>>.
+Component entry point is [`DependencyGraphBuilder`](./apidocs/org/apache/maven/shared/dependency/graph/DependencyGraphBuilder.html).