Tidied up download page #1426

raupachz · 2025-10-12T08:54:09Z

Hello,

my try on improving the Downloads page.

System requirements are now inline with the text. I don't think there is a need for everything mentioned and it is less visually dominated now.

Other releases is removed and its content is moved into Apache Maven and Maven Daemon. Daemon got its own section. If it were my call I would even go as far and drop Maven Daemon from the Downloads page. Not saying it is great tech, but the page is about downloading Maven not about Daemon.

I swapped the position of 4.x and older 3.8.x. I think this is better. Always nice to show that things are moving forward, but not ignoring the older versions.

Following this checklist to help us incorporate your
contribution quickly and easily:

Your pull request should address just one issue, without pulling in other changes.
Each commit in the pull request should have a meaningful subject line and body.
Note that commits might be squashed by a maintainer on merge.
Run mvn site and examine output in target/site directory.
Site will also be built on your pull request automatically and attached to GitHub Action result.

If your pull request is about ~20 lines of code you don't need to sign an
Individual Contributor License Agreement if you are unsure
please ask on the developers list.

To make clear that you license your contribution under
the Apache License Version 2.0, January 2004
you have to acknowledge this by using the following check-box.

I hereby declare this contribution to be licenced under the Apache License Version 2.0, January 2004
In any other case, please file an Apache Individual Contributor License Agreement.

raupachz · 2025-10-12T08:55:46Z

Ah. Sorry. I messed up. That is more than one commit. Even one that shouldn't belong here. I will try to sequeeze it into again.

content/xdoc/download.xml.vm

Bukama · 2025-10-12T16:23:51Z

If it were my call I would even go as far and drop Maven Daemon from the Downloads page.

It was added earlier this year (#719) as there is no other download page for Daemon. And I think it's fine. It's a (and the only which needs external download) tool by the Maven team and of Maven.

--
About the PR: I like to update the structure to have Maven releases together and Maven Daemon releases together.

We should make sure use this PR to also fix headings

On live page it is:

H1: Downloading Maven 3.9.11
- H2: System requirements
- H2: Maven Daemon
H1: Other releases
- H2: Previous Maven 3.8
- H2: Preview Maven 4
- H2: Preview Daemon 2

This violates basic rules of HTML where only one H1 is allowed for the page title, which is not Downloading Maven 3.9.11 but should "Downloding Apache Maven - Maven" according to title tag. I think "Downloading Maven" is better.

The then following structure should be something like this

H1 Download Maven
H2: Maven
- H3: Current Stable: Maven 3.9.11
- H3: Preview 4.x
- H3: Previous Maven 3.8
H2: Maven Daemon
- H3: Current Stable: Maven Daemon 1
- H3: Preview Daemon 2

And also add a TOC to the page so users can jump to the section they want

raupachz · 2025-10-18T08:06:05Z

@Bukama

The then following structure should be something like this

Your proposal also has two H1s. Mistake?

H1: Download Maven
H2: Maven
H2: Maven Daemon

Like this?

Bukama · 2025-10-18T08:51:16Z

@Bukama

The then following structure should be something like this

Your proposal also has two H1s. Mistake?

H1: Download Maven H2: Maven H2: Maven Daemon

Like this?

opps yeah and the one below then H3. Will edit.

edit: also renamed PR title cause it's about download page

Bukama · 2025-10-18T13:28:11Z

When you update your PR, please rebase it - the current diff contains a lot of changes from earlier/merged PRs. Thank you!

elharo · 2025-10-18T13:49:54Z

content/markdown/whatsnewinmaven4.md

 However, this still required the usage of the [Flatten Maven Plugin][20] for full functionality.
 Since Maven 4, no additional plugin is needed; full built-in support is provided.
-You can now use variables as versions in your configuration.
+You can now use **any variable** as versions in your configuration, not just predefined ones.


as a version

elharo · 2025-10-18T13:50:48Z

content/markdown/whatsnewinmaven4.md


+### Maven Upgrade Tool
+
+If you're currently using Maven 3 and want to upgrade to Maven 4, you can use the [Maven Upgrade Tool](https://maven.apache.org/tools/mvnup.html).


"If you're currently using Maven 3 and want to upgrade to Maven 4" -- "To upgrade from maven 3 to Maven 4"

elharo · 2025-10-18T13:51:08Z

content/markdown/whatsnewinmaven4.md

+
+The Maven Upgrade Tool tool can be used to:
+
+* Automatically update your POM files to use the new model version 4.1.0 (if desired)


Delete "Automatically"

elharo · 2025-10-18T13:51:18Z

content/markdown/whatsnewinmaven4.md

+
+* Automatically update your POM files to use the new model version 4.1.0 (if desired)
+* Identify deprecated features and suggest replacements
+* Help migrate from deprecated plugin configurations to their modern equivalents


Delete "Help"

* System requirements are now less dominant * Maven Maven Daemon has its own section * Removed other releases into Apache Maven and Daemon section * Swapped the positions of Maven 4.x and 3.8.x releases

raupachz · 2025-10-19T07:55:49Z

@elharo

When you update your PR, please rebase it - the current diff contains a lot of changes from earlier/merged PRs. Thank you!

I messed up. Your comments ended up on the wrong PR. My bad.

raupachz · 2025-10-19T08:06:04Z

@Bukama

And also add a TOC to the page so users can jump to the section they want

I like all your idea, but I am a bit stuck at the moment. Haven't figured out this whole Velocity and Maven Fluido Skin combination.

Bukama · 2025-10-26T12:53:18Z

@Bukama

And also add a TOC to the page so users can jump to the section they want

I like all your idea, but I am a bit stuck at the moment. Haven't figured out this whole Velocity and Maven Fluido Skin combination.

sure, just ping me if you want another review or help (not sure where you are stucked exactly atm)

raupachz · 2025-10-27T20:19:32Z

Hi @Bukama

thanks for getting in touch. Very much appreciated.

Here is where I am stuck at the moment.

I am trying to implement your proposal:

H1 Download Maven
H2: Maven
H3: Current Stable: Maven 3.9.11
H3: Preview 4.x
H3: Previous Maven 3.8
H2: Maven Daemon
H3: Current Stable: Maven Daemon 1
H3: Preview Daemon 2

dnd also add a TOC to the page so users can jump to the section they want.

The file download.xml.vm is processed by Apache Velocity. At least I think it is.

I haven't figured out where the whole magic happens.

<section name="...">

renders a H1 .

<subsection name="...">

renders a h2. There is no <subsubsection> to render a H3.

And I haven't looked into deeply enough into the templating stuff long enough to find out if there is a TOC element or macro. Not sure what the proper naming is.

slawekjaranowski · 2025-10-27T20:22:45Z

Please wait for

Maven 3.8.x - EOL #842

I'm going to merge it at the end of month

Bukama · 2025-10-27T20:52:07Z

... to find out if there is a TOC element or macro.

For TOC you can use the following in .apt.vm files (adjust parameters so they fit)

%{toc|section=0|fromDepth=2|toDepth=5}

I am trying to implement your proposal:

You should be able to just work with

** H2
*** H3

as the base is still .apt
At least this is what I see in an old .apt.vm file I converted to markdown

https://github.com/apache/maven-site/pull/1372/files#diff-0b119b138d8a4db3df277ed507975265c891da9d5752df3e6e6f1b4c69792d8dL29

Hope this helps, otherwise I would have to have a closer look myself tomorrow.

Bukama · 2025-10-27T20:53:10Z

Please wait for

Maven 3.8.x - EOL #842

I'm going to merge it at the end of month

Sure :)

Bukama · 2025-11-07T14:16:40Z

@raupachz The 3.8 EOL has been merged, you can update the PR if you want :)

raupachz force-pushed the downloads branch from 97e6efe to 81830ba Compare October 12, 2025 08:58

raupachz mentioned this pull request Oct 12, 2025

Downloads instead of Download #1425

Merged

5 tasks

elharo requested changes Oct 12, 2025

View reviewed changes

content/xdoc/download.xml.vm Show resolved Hide resolved

Bukama changed the title ~~Tidied up documentation page~~ Tidied up download page Oct 18, 2025

elharo reviewed Oct 18, 2025

View reviewed changes

Tidied up documentation page

e4b73da

* System requirements are now less dominant * Maven Maven Daemon has its own section * Removed other releases into Apache Maven and Daemon section * Swapped the positions of Maven 4.x and 3.8.x releases

raupachz force-pushed the downloads branch from 8d21063 to e4b73da Compare October 19, 2025 07:50

stet

67418b1

Downloads

4352c6b


		### Maven Upgrade Tool

		If you're currently using Maven 3 and want to upgrade to Maven 4, you can use the [Maven Upgrade Tool](https://maven.apache.org/tools/mvnup.html).


		The Maven Upgrade Tool tool can be used to:

		* Automatically update your POM files to use the new model version 4.1.0 (if desired)

Tidied up download page #1426

Are you sure you want to change the base?

Tidied up download page #1426

Uh oh!

Conversation

raupachz commented Oct 12, 2025

Uh oh!

raupachz commented Oct 12, 2025

Uh oh!

Uh oh!

Bukama commented Oct 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

raupachz commented Oct 18, 2025

Uh oh!

Bukama commented Oct 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Bukama commented Oct 18, 2025

Uh oh!

elharo Oct 18, 2025

Choose a reason for hiding this comment

Uh oh!

elharo Oct 18, 2025

Choose a reason for hiding this comment

Uh oh!

elharo Oct 18, 2025

Choose a reason for hiding this comment

Uh oh!

elharo Oct 18, 2025

Choose a reason for hiding this comment

Uh oh!

raupachz commented Oct 19, 2025

Uh oh!

raupachz commented Oct 19, 2025

Uh oh!

Bukama commented Oct 26, 2025

Uh oh!

raupachz commented Oct 27, 2025

Uh oh!

slawekjaranowski commented Oct 27, 2025

Uh oh!

Bukama commented Oct 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Bukama commented Oct 27, 2025

Uh oh!

Bukama commented Nov 7, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Bukama commented Oct 12, 2025 •

edited

Loading

Bukama commented Oct 18, 2025 •

edited

Loading

Bukama commented Oct 27, 2025 •

edited

Loading