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/09 23:18:57 UTC
(maven) branch agent/xdoc-index-to-markdown created (now d041a2f870)
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a change to branch agent/xdoc-index-to-markdown
in repository https://gitbox.apache.org/repos/asf/maven.git
at d041a2f870 Convert the introduction page from xdoc to Markdown
This branch includes the following new commits:
new 112af0049b Rename the introduction page ahead of converting it
new d041a2f870 Convert the introduction page from xdoc to Markdown
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
(maven) 02/02: Convert the introduction page from xdoc to Markdown
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch agent/xdoc-index-to-markdown
in repository https://gitbox.apache.org/repos/asf/maven.git
commit d041a2f8700a027b468f18c3fc6588ee4d5e950f
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 01:18:34 2026 +0200
Convert the introduction page from xdoc to Markdown
This was the last xdoc content page in the repository; every other page
under src/site is already Markdown. The page used no Velocity, so it drops
the .vm-less xdoc suffix and becomes src/site/markdown/index.md, still
rendering to index.html.
The dependency diagram stays as an inline <object> tag, which Markdown has
no syntax for and Doxia passes through unchanged.
Verified by rendering the site before and after: the page anchor
Apache_Maven_4.x, the title, the author metadata, the visible text and
every link target are identical, and so is every other page. The generated
markup differs only in whitespace.
Generated-by: Claude Opus 5 (1M context)
---
src/site/markdown/index.md | 48 +++++++++++++++++++---------------------------
1 file changed, 20 insertions(+), 28 deletions(-)
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index 29adacad5b..9c0465609b 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,4 +1,8 @@
-<?xml version="1.0"?>
+---
+title: Introduction
+author:
+ - Hervé Boutemy
+---
<!--
Licensed to the Apache Software Foundation (ASF) under one
@@ -19,35 +23,23 @@ specific language governing permissions and limitations
under the License.
-->
-<document>
+# Apache Maven 4.x
- <properties>
- <title>Introduction</title>
- <author email="hboutemy_AT_apache_DOT_org">Hervé Boutemy</author>
- </properties>
+Maven is a project development management and
+comprehension tool.
- <body>
+Based on the concept of a project object model:
+builds, dependency management, documentation creation, site
+publication, and distribution publication are all controlled from
+[the `pom.xml` declarative file](./api/maven-api-model/maven.html).
- <section name="Apache Maven 4.x">
+Maven can be extended by
+[plugins](https://maven.apache.org/plugins/) to utilise a
+number of other development tools for reporting or the build
+process.
- <p>Maven is a project development management and
- comprehension tool.</p>
- <p> Based on the concept of a project object model:
- builds, dependency management, documentation creation, site
- publication, and distribution publication are all controlled from
- <a href="./api/maven-api-model/maven.html">the <code>pom.xml</code> declarative file</a>.</p>
- <p>Maven can be extended by
- <a href="https://maven.apache.org/plugins/">plugins</a> to utilise a
- number of other development tools for reporting or the build
- process.</p>
+Learn more about [configuring Maven](configuring.html) and [Maven's configuration](maven-configuration.html).
- <p>Learn more about <a href="configuring.html">configuring Maven</a> and <a href="maven-configuration.html">Maven's configuration</a>.</p>
-
- <p>
- <object data="images/maven-deps.svg"></object>
- </p>
- </section>
-
- </body>
-
-</document>
+<p>
+<object data="images/maven-deps.svg"></object>
+</p>
(maven) 01/02: Rename the introduction page ahead of converting it
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch agent/xdoc-index-to-markdown
in repository https://gitbox.apache.org/repos/asf/maven.git
commit 112af0049bb05ef9a40de99581bf3cf785712b97
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 01:18:34 2026 +0200
Rename the introduction page ahead of converting it
Git's rename detection is similarity-based, so a rename and a rewrite in
one commit is recorded as a delete plus an add and git log --follow stops
there. Please merge or rebase rather than squash.
Generated-by: Claude Opus 5 (1M context)
---
src/site/{xdoc/index.xml => markdown/index.md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
diff --git a/src/site/xdoc/index.xml b/src/site/markdown/index.md
similarity index 100%
rename from src/site/xdoc/index.xml
rename to src/site/markdown/index.md