From 49b8e123d98de65431fb945620269c04171768f9 Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Sun, 9 Aug 2026 19:13:40 +0200 Subject: [PATCH 1/2] Rename the site documents ahead of converting them 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/get-involved.xml => markdown/get-involved.md} | 0 .../ref/available-components.md} | 0 2 files changed, 0 insertions(+), 0 deletions(-) rename src/site/{xdoc/get-involved.xml => markdown/get-involved.md} (100%) rename src/site/{xdoc/ref/available-components.xml => markdown/ref/available-components.md} (100%) diff --git a/src/site/xdoc/get-involved.xml b/src/site/markdown/get-involved.md similarity index 100% rename from src/site/xdoc/get-involved.xml rename to src/site/markdown/get-involved.md diff --git a/src/site/xdoc/ref/available-components.xml b/src/site/markdown/ref/available-components.md similarity index 100% rename from src/site/xdoc/ref/available-components.xml rename to src/site/markdown/ref/available-components.md From f0e41c7bd293f2f92b14a804c77826ec41e5db7d Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Sun, 9 Aug 2026 19:14:07 +0200 Subject: [PATCH 2/2] Convert the remaining xdoc pages to Markdown get-involved and ref/available-components, converted with doxia-converter. The YAML front matter is kept: it carries each page's title and author, which the skin turns into and <meta name="author">. 404.xml stays xdoc on purpose. It carries a <head> block with a <base href> and absolute stylesheet links, and Markdown front matter can only produce <title> and <meta>; a 404 page is served from arbitrary URLs, so the <base> cannot be dropped. Verified by rendering the site before and after: both pages are identical in title, author, visible text and every link target. Generated-by: Claude Opus 5 (1M context) --- src/site/markdown/get-involved.md | 130 +++++++----------- src/site/markdown/ref/available-components.md | 50 +++---- 2 files changed, 62 insertions(+), 118 deletions(-) diff --git a/src/site/markdown/get-involved.md b/src/site/markdown/get-involved.md index c68ae5d..4a880e3 100644 --- a/src/site/markdown/get-involved.md +++ b/src/site/markdown/get-involved.md @@ -1,4 +1,10 @@ -<?xml version="1.0" encoding="UTF-8"?> +--- +title: Getting Involved +author: + - Rahul Thakur + - Olivier Lamy +--- + <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -17,86 +23,42 @@ KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> -<document xmlns="http://maven.apache.org/XDOC/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 https://maven.apache.org/xsd/xdoc-2.0.xsd"> - <properties> - <title>Getting Involved - Rahul Thakur - Olivier Lamy - - - -
- -

- Contributions are welcome. The full guide lives with the code: - CONTRIBUTING.md. - The short version is below. -

- - -

- GitHub issues, on the repository concerned. - That is where the maintainers are. There is no Plexus mailing list — if you find one referenced - in older documentation on this site, it is defunct. -

-

- Each project on the overview page links to its own repository. If you - aren't sure which one owns the behaviour you're seeing, open the issue wherever seems closest - and we'll move it. -

- - - -

- mvn verify. No profile or local setup is required. CI builds across JDK 8, 21 and 25 - on Linux, Windows and macOS. -

- - - -

- Formatting is enforced by the build, via - Spotless and - palantir-java-format. Don't hand-format, - and don't reformat code you aren't otherwise touching. Before pushing: -

- mvn spotless:apply -

- If CI fails on spotless:check, running that command and committing the result is the - whole fix. -

-

- This page previously offered maven-eclipse-codestyle.xml and - maven-idea-codestyle.xml for import into your IDE. Those predate Spotless and no longer - match what the build enforces, so they are no longer linked from here. The files themselves are still - served, so any existing link to them keeps working. -

- - - -

- New files take the standard header used by the files around them — Apache-2.0 for everything except - Modello, which is MIT. Please do not update or normalise existing copyright headers, including the - older Codehaus Foundation ones; they record who contributed what. -

- - - -

- One concern per pull request, a test where the change is testable, and an explanation of why in - the description. These libraries are consumed transitively across most of the Maven plugin ecosystem, - so changes to public API need discussion in an issue first — deprecate rather than remove. -

- - - -

- Please do not open a public issue for a vulnerability. See - SECURITY.md. -

- - -
- - + +# Getting Involved + +Contributions are welcome. The full guide lives with the code: [CONTRIBUTING.md](https://github.com/codehaus-plexus/.github/blob/master/CONTRIBUTING.md). The short version is below. + +## Where to ask + +[GitHub issues](https://github.com/codehaus-plexus), on the repository concerned. That is where the maintainers are. There is no Plexus mailing list — if you find one referenced in older documentation on this site, it is defunct. + +Each project on the [overview page](./index.html) links to its own repository. If you aren't sure which one owns the behaviour you're seeing, open the issue wherever seems closest and we'll move it. + +## Building + +`mvn verify`. No profile or local setup is required. CI builds across JDK 8, 21 and 25 on Linux, Windows and macOS. + +## Code style + +Formatting is enforced by the build, via [Spotless](https://github.com/diffplug/spotless) and [palantir-java-format](https://github.com/palantir/palantir-java-format). Don't hand-format, and don't reformat code you aren't otherwise touching. Before pushing: + +```unknown +mvn spotless:apply +``` + +If CI fails on `spotless:check`, running that command and committing the result is the whole fix. + +This page previously offered `maven-eclipse-codestyle.xml` and `maven-idea-codestyle.xml` for import into your IDE. Those predate Spotless and no longer match what the build enforces, so they are no longer linked from here. The files themselves are still served, so any existing link to them keeps working. + +## Licence headers + +New files take the standard header used by the files around them — Apache-2.0 for everything except Modello, which is MIT. Please do not update or normalise existing copyright headers, including the older Codehaus Foundation ones; they record who contributed what. + +## Pull requests + +One concern per pull request, a test where the change is testable, and an explanation of _why_ in the description. These libraries are consumed transitively across most of the Maven plugin ecosystem, so changes to public API need discussion in an issue first — deprecate rather than remove. + +## Security + +Please do not open a public issue for a vulnerability. See [SECURITY.md](https://github.com/codehaus-plexus/.github/blob/master/SECURITY.md). + diff --git a/src/site/markdown/ref/available-components.md b/src/site/markdown/ref/available-components.md index 02f6486..e61a9ff 100644 --- a/src/site/markdown/ref/available-components.md +++ b/src/site/markdown/ref/available-components.md @@ -1,4 +1,10 @@ - +--- +title: Available Plexus Components +author: + - Rahul Thakur + - Olivier Lamy +--- + - - - Available Plexus Components - Rahul Thakur - Olivier Lamy - - - -
- -

- This page is out of date and is kept only so existing links to it keep working. -

- -

- The current list of Plexus libraries and components, with links to their sites, is on the - overview page. -

- -

- The list that used to be here described the components as they stood when Plexus was still an - IoC container. Most of what it advertised no longer exists in any form — plexus-cli, - plexus-spring, plexus-contextualizer, plexus-xwork-integration, - plexus-mail-sender, plexus-cache and plexus-swizzle are all - gone or archived — and it listed none of the components that are actually maintained today. - Rather than leave that standing, the content has been removed and the overview page is now the - single index. -

- -
- - + +# Available Plexus Components + +**This page is out of date and is kept only so existing links to it keep working.** + +The current list of Plexus libraries and components, with links to their sites, is on the [overview page](../index.html). + +The list that used to be here described the components as they stood when Plexus was still an IoC container. Most of what it advertised no longer exists in any form — `plexus-cli`, `plexus-spring`, `plexus-contextualizer`, `plexus-xwork-integration`, `plexus-mail-sender`, `plexus-cache` and `plexus-swizzle` are all gone or archived — and it listed none of the components that are actually maintained today. Rather than leave that standing, the content has been removed and the overview page is now the single index. +