Skip to content

Update navigation for User and Plugin Developer Centres: Maven 3 vs Maven 4 #789

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

sparsick
Copy link
Contributor

Based on the proposal in #726

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.

@sparsick
Copy link
Contributor Author

Currently, I changed the structure of the navigation menu. I could also reorder the sources based on that structure. What do you think?

@hboutemy
Copy link
Member

hboutemy commented Jun 3, 2025

trying to make the update clearly visible before any discussion:

  • Users Centre menu
    before / after =
    image image

  • Plugin Developer Centre:
    before / after =
    image image

@hboutemy
Copy link
Member

hboutemy commented Jun 3, 2025

I could also reorder the sources based on that structure

in general, we avoid moving files to not loose search engines indexing

@hboutemy
Copy link
Member

hboutemy commented Jun 3, 2025

on "Plugin Developer Center":
I think it's too early to have that prominent "Maven 3" section
but immediately adding a "Maven 4" entry to starting introducing Maven 4-specific plugins topic (using experimental Maven 4 API that will be provided in Maven 4.0.0) would be a good idea to start communicating reasonably about it
(and re-explain that Maven 3 plugins are expected to work in Maven 4, no hurry: future is not yet now)

@hboutemy
Copy link
Member

hboutemy commented Jun 3, 2025

on "User Center":

  • introduction of "Maven Build Fundamentals" and "Maven Build Config Fundamentals": splitting in 2 groups looks an interesting idea
  • introduction of "Maven 3" entry with the "Getting Started Guide" (and all its content": I'm not convinced this is the right time for this "Maven 3" entry, and I'm not convinced at all about the content

@hboutemy hboutemy changed the title Improving navigation for User Centre and Plugin Developer Centre Update navigation for User and Plugin Developer Centres: Maven 3 vs Maven 4 Jun 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants