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-site.git

commit e53e1f2c545fc44a68921bc159965771d4a370aa
Author: Sylwester Lachiewicz <[email protected]>
AuthorDate: Mon Nov 2 07:02:35 2026 +0000

    Rework the home page as cards and convert it to Markdown
    
    Card titles are paragraphs, not headings: Doxia turns every heading into
    a section, which would break out of the card markup. The "How to Get
    Support" and "Apache Software Foundation" headings keep their anchors.
---
 content/markdown/index.md.vm   | 116 +++++++++++++++++++++++++++++++++
 content/resources/css/site.css | 141 +++++++++++++++++++++++++++++++++++++----
 content/xdoc/index.xml.vm      | 137 ---------------------------------------
 3 files changed, 246 insertions(+), 148 deletions(-)

diff --git a/content/markdown/index.md.vm b/content/markdown/index.md.vm
new file mode 100644
index 00000000..27e3553f
--- /dev/null
+++ b/content/markdown/index.md.vm
@@ -0,0 +1,116 @@
+---
+title: Welcome to Apache Maven
+author:
+  - Brett Porter
+  - Jason van Zyl
+  - Olivier Lamy
+---
+
+<!--
+
+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.
+
+-->
+
+# Welcome to Apache Maven
+
+<div class="mh-hero">
+  <p class="mh-lead">Apache Maven builds, tests and documents Java projects 
from a single project object model (POM).</p>
+  <p class="mh-actions">
+    <a class="mh-btn mh-btn-primary" href="download.html">Download Maven 
${currentStableVersion}</a>
+    <a class="mh-btn" 
href="guides/getting-started/maven-in-five-minutes.html">Maven in 5 minutes</a>
+    <a class="mh-btn" href="what-is-maven.html">What is Maven?</a>
+  </p>
+</div>
+
+<div class="mh-callout">
+  <p><strong>Maven 4 (${current4xVersion})</strong> is on its way. Read <a 
href="whatsnewinmaven4.html">what's new</a>, <a 
href="guides/mini/guide-migration-to-mvn4.html">migrate a project</a>, or let 
the <a href="tools/mvnup.html">Maven Upgrade Tool</a> do the heavy lifting.</p>
+</div>
+
+#[[##]]# Use
+
+<div class="mh-grid">
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="run.html">Build a project</a></p>
+    <p><a href="download.html">Download</a>, <a 
href="install.html">install</a>, <a href="configure.html">configure</a> and <a 
href="run.html">run</a> Maven.</p>
+  </div>
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="plugins/index.html">Plugins</a></p>
+    <p>The plugins that do the actual work: compile, test, package, deploy and 
more.</p>
+  </div>
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="extensions/index.html">Extensions</a></p>
+    <p>Hook into the build itself: build caches, wagons, custom lifecycle 
behaviour.</p>
+  </div>
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="tools/index.html">Tools</a></p>
+    <p>Maven Daemon, Maven Wrapper, Maven Shell and the Maven Upgrade Tool.</p>
+  </div>
+</div>
+
+#[[##]]# Extend
+
+<div class="mh-grid">
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="plugin-developers/index.html">Write a 
plugin</a></p>
+    <p>Package your own build logic as a reusable Maven plugin.</p>
+  </div>
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="repository/index.html">Publish to 
Central</a></p>
+    <p>Get your project and its metadata into the Maven Central Repository, 
whichever build tool you use.</p>
+  </div>
+</div>
+
+#[[##]]# Contribute
+
+<div class="mh-grid">
+  <div class="mh-card">
+    <p class="mh-card-title"><a 
href="guides/development/guide-helping.html">Help Maven</a></p>
+    <p>Answer questions, improve these docs, triage issues. No commit rights 
needed.</p>
+  </div>
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="developers/index.html">Develop 
Maven</a></p>
+    <p>Conventions, release process and how to work on Maven core and its 
plugins.</p>
+  </div>
+</div>
+
+<p class="mh-note">Looking for something specific? The <a 
href="guides/index.html">documentation index</a> lists every guide, reference 
page and cookbook example.</p>
+
+#[[##]]# How to Get Support
+
+<div class="mh-grid mh-grid-compact">
+  <div class="mh-card">
+    <p class="mh-card-title">Search first</p>
+    <p>The <a href="issue-management.html">issue tracker</a>, the <a 
href="mailing-lists.html">mailing list archives</a> and the <a 
href="https://cwiki.apache.org/confluence/display/MAVEN";>wiki</a> often already 
have the answer.</p>
+  </div>
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="mailing-lists.html">Ask on users@</a></p>
+    <p>The Maven Users mailing list is the main support channel, answered by 
users and developers alike and archived for the next person.</p>
+  </div>
+  <div class="mh-card">
+    <p class="mh-card-title"><a href="community.html">Chat on Slack</a></p>
+    <p>Reach the Maven developers directly in the ASF Slack workspace.</p>
+  </div>
+</div>
+
+#[[##]]# Apache Software Foundation
+
+<div class="mh-asf">
+  <a href="https://www.apache.org/events/current-event.html";><img 
src="https://www.apache.org/events/current-event-234x60.png"; alt="Apache 
Events"/></a>
+  <p>Maven is a project of the <a href="https://www.apache.org/";>Apache 
Software Foundation</a>. Thanks to the <a 
href="https://www.apache.org/foundation/thanks.html";>sponsors</a> who keep it 
running (<a href="https://www.apache.org/foundation/sponsorship.html";>become 
one</a>). Meet the Maven team at <a 
href="https://www.apache.org/events/current-event.html";>Apache events</a>; ask 
on the users@ list who is going.</p>
+</div>
diff --git a/content/resources/css/site.css b/content/resources/css/site.css
index 3cdc8665..fc863303 100644
--- a/content/resources/css/site.css
+++ b/content/resources/css/site.css
@@ -63,24 +63,143 @@ body ul {
   background-color: #f9f9f9;
 }
 
-.home-section-heading,
-.home-section-links {
+/* ---- Home page (index.md.vm) ----
+   Plain CSS grid so the layout does not depend on the skin's Bootstrap 
version. */
+
+.mh-hero {
+  margin: 0.5em 0 1.5em;
+}
+
+.mh-lead {
+  font-size: 1.35em;
+  line-height: 1.45;
+  max-width: 36em;
+  color: #333;
+}
+
+.mh-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5em;
+  margin-top: 1em;
+}
+
+a.mh-btn,
+a.mh-btn:visited {
+  display: inline-block;
+  padding: 0.55em 1.1em;
+  border: 1px solid #c5c5c5;
+  border-radius: 4px;
+  background: #fff;
+  color: #333;
+  font-weight: 600;
+  text-decoration: none;
+}
+
+a.mh-btn:hover,
+a.mh-btn:focus {
+  border-color: #0088cc;
+  color: #0088cc;
+  text-decoration: none;
+}
+
+a.mh-btn-primary,
+a.mh-btn-primary:visited {
+  background: #006da3;
+  border-color: #005a87;
+  color: #fff;
+}
+
+a.mh-btn-primary:hover,
+a.mh-btn-primary:focus {
+  background: #005a87;
+  color: #fff;
+}
+
+.mh-callout {
+  border-left: 4px solid #d6573a; /* Maven feather orange */
+  background: #fdf3ef;
+  padding: 0.75em 1em;
+  margin: 0 0 2em;
+}
+
+.mh-callout p {
+  margin: 0;
+}
+
+h2.mh-group {
+  font-size: 1.1em;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: #777;
+  border-bottom: 1px solid #e5e5e5;
+  padding-bottom: 0.3em;
+  margin: 1.8em 0 0.9em;
+}
+
+.mh-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(14em, 1fr));
+  gap: 1em;
+}
+
+.mh-card {
+  border: 1px solid #e5e5e5;
+  border-radius: 6px;
+  padding: 0.9em 1em;
+  background: #fff;
+  transition: border-color 0.15s, box-shadow 0.15s;
+}
+
+.mh-card:hover {
+  border-color: #0088cc;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.06);
+}
+
+.mh-card-title {
+  font-size: 1.1em;
   font-weight: bold;
-  white-space: nowrap;
+  margin: 0 0 0.35em;
+  line-height: 1.3;
 }
 
-.home-section-heading {
-  font-size: 1.75em;
+.mh-card p:not(.mh-card-title) {
+  margin: 0;
+  color: #555;
+}
+
+.mh-grid-compact .mh-card {
+  background: #fafafa;
+}
+
+.mh-note {
+  margin-top: 1.5em;
+  color: #555;
 }
 
-.home-section-links {
-  font-size: 1.25em;
+.mh-asf {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 1em;
+  margin-top: 2.5em;
+  padding-top: 1em;
+  border-top: 1px solid #e5e5e5;
+  color: #666;
+  font-size: 0.95em;
+}
+
+.mh-asf p {
+  flex: 1 1 20em;
+  margin: 0;
 }
 
-/* on a phone the headings wrap instead of running past the edge of the screen 
*/
 @media (max-width: 767px) {
-  .home-section-heading,
-  .home-section-links {
-    white-space: normal;
+  .mh-lead {
+    font-size: 1.15em;
+  }
+  .mh-actions a.mh-btn {
+    flex: 1 1 100%;
+    text-align: center;
   }
 }
diff --git a/content/xdoc/index.xml.vm b/content/xdoc/index.xml.vm
deleted file mode 100644
index cb373755..00000000
--- a/content/xdoc/index.xml.vm
+++ /dev/null
@@ -1,137 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-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.
-
--->
-<document>
-  <properties>
-    <title>Welcome to Apache Maven</title>
-    <author email="[email protected]">Brett Porter</author>
-    <author email="[email protected]">Jason van Zyl</author>
-    <author email="[email protected]">Olivier Lamy</author>
-  </properties>
-  <body>
-
-    <section name="Welcome to Apache Maven">
-      <p>
-        Apache Maven is a build tool for Java projects. Using a project object 
model
-        (POM), Maven manages a project's compilation, testing, and 
documentation.
-      </p>
-      <p>
-        You can find more information in the "About Maven"
-        section of the sidebar. This includes an in-depth description of <a 
href="what-is-maven.html">what Maven is</a> and a list of some of its main 
features.
-      </p>
-      <p>
-        This site is separated into the following sections:
-      </p>
-      <table>
-      <tr>
-        <th class="home-section-heading" rowspan="3">Use</th>
-        <th class="home-section-links">
-          <a href="download.html">Download</a>, <a 
href="install.html">Install</a>, <a href="configure.html">Configure</a>, <a 
href="run.html">Run</a> Maven
-        </th>
-        <th class="home-section-links">
-           <a href="plugins/index.html">Maven Plugins</a> and <a 
href="extensions/index.html">Maven Extensions</a>
-        </th>
-      </tr>
-      <tr>
-        <td>Information for those needing to build a project that uses 
Maven</td>
-        <td>
-            Lists of plugins and extensions to help with your builds.
-        </td>
-      </tr>
-      <tr>
-        <td><b>Maven 4</b>: Learn <a href="whatsnewinmaven4.html">what's 
new</a> and <a href="/guides/mini/guide-migration-to-mvn4.html">how to migrate 
a project</a> to Maven 4. The <a href="/tools/mvnup.html">Maven Upgrade 
Tool</a> provides upgrade support.</td>
-        <td>
-          Upcoming: How to migrate plugins to the new Maven 4 API?
-        </td>
-      </tr>
-      <tr>
-        <th class="home-section-heading" rowspan="2">Extend</th>
-        <th class="home-section-links"><a 
href="plugin-developers/index.html">Write Maven Plugins</a></th>
-        <th class="home-section-links"><a href="repository/index.html">Improve 
the Maven Central Repository</a></th>
-      </tr>
-      <tr>
-        <td>
-            Information for developers writing Maven plugins.
-        </td>
-        <td>
-            Information for those who may or may not use Maven, but are 
interested in getting project metadata into the
-            <a href="repository/index.html">central repository</a>.
-        </td>
-      </tr>
-      <tr>
-        <th class="home-section-heading" rowspan="2">Contribute</th>
-        <th class="home-section-links"><a 
href="guides/development/guide-helping.html">Help Maven</a></th>
-        <th class="home-section-links"><a href="developers/index.html">Develop 
Maven</a></th>
-      </tr>
-      <tr>
-        <td>
-            Information if you'd like to get involved. Maven is an open source 
community and welcomes contributions.
-        </td>
-        <td>
-            Information for those who are currently Maven developers, or who 
are interested
-            in contributing to the Maven project itself.
-        </td>
-      </tr>
-      </table>
-      <p>
-        Each guide is divided into a number of trails to get you started on a 
particular topic, and includes a
-        reference area and a "cookbook" of common examples.
-      </p>
-      <p>
-        You can access the guides at any time from the left navigation.
-        If you are looking for a quick reference, you can use the <a 
href="guides/index.html">documentation index</a>.
-      </p>
-
-      <h3>How to Get Support</h3>
-      <p>
-        Support for Maven is available in a variety of different forms.
-      </p>
-      <p>
-        To get started, search the documentation,
-        <a href="issue-management.html">issue management system</a>, the <a 
href="https://cwiki.apache.org/confluence/display/MAVEN";>wiki</a>,
-        or the <a href="mailing-lists.html">mailing list archives</a> to
-        see if the problem has been solved or reported before.
-      </p>
-      <p>
-        If the problem has not been reported before, the recommended way to 
get help is to
-        subscribe to the <a href="mailing-lists.html">Maven Users Mailing 
list</a>. Many other users and Maven developers
-        will answer your questions there, and the answer will be archived for 
others in the future.
-      </p>
-      <p>
-        You can also reach the Maven developers on <a 
href="community.html">Slack</a>.
-      </p>
-
-      <h3>Apache Software Foundation</h3>
-      <p>
-        Maven is a part of the Apache Software Foundation. We'd like to <a 
href="https://www.apache.org/foundation/thanks.html";>thank
-        the sponsors</a> that provide financial assistance to the foundation. 
For more information on how you can support the
-        foundation, see the <a 
href="https://www.apache.org/foundation/sponsorship.html";>sponsorship</a> page.
-      </p>
-      <p>
-        <a href="https://www.apache.org/events/current-event.html";>
-          <img src="https://www.apache.org/events/current-event-234x60.png"; 
alt="Apache Events" style="float: left"/>
-        </a>
-        You can also attend <a 
href="https://www.apache.org/events/current-event.html";>Apache Events</a>. Ask 
on the <a href="mailing-lists.html">Maven User mailing list</a>
-        if Maven team members will be there. It can be a great opportunity to 
meet them.
-      </p>
-    </section>
-  </body>
-</document>

Reply via email to