[slachiewicz]

Part of #58.

profile/README.md — the page rendered at the top of https://github.com/codehaus-plexus — is still GitHub's starter template. In full, currently:

Hi there 👋

It's All the Plexus code here from the old good Codehaus

followed by GitHub's commented-out "here are some ideas to get you started" block, still in the file.

This replaces it with an actual overview.

What's in it

• One paragraph on what Plexus is today: small libraries that Maven and its plugins are built on. Most people reach us through a transitive dependency, so the page leads with that rather than with history.
• A short note that the IoC container is retired and Sisu replaced it. Worth stating plainly on the front page, because the name still makes people expect a container — and because our own site currently says both things in different places.
• Three tables (libraries / components / tooling) with the real groupId:artifactId, a one-line description, and a link to Central.
• An explicit Retired table for the 8 archived repos, each with what to use instead. plexus-cipher → plexus-sec-dispatcher, which absorbed it; plexus-containers → Sisu; and so on.
• Links to CONTRIBUTING and SECURITY, which are added in a companion PR.

Two deliberate choices

Versions are shields.io badges, not literals, so this page doesn't need editing after every release.

The one-line descriptions were written against the source rather than from the existing metadata — several repos have no description anywhere to copy from, and where one existed it was sometimes wrong. For example plexus-java is described here as reading module-info and splitting the classpath from the module path, which is what jpms/LocationManager actually does.

Please check

The retired-repo replacements are the part where I'd most like a second opinion, particularly plexus-component-factories and plexus-maven-plugin, where I've written "nothing — obsolete under Sisu". If those still have a live use I don't know about, say so.