Hi, I for one like Martijn's design. I disagree that only people already convinced of Maven should be addressed.
Personally I dislike documentation pages which do not tell people what the software is good for and why I should use or try it. Besides the start page, the rest is easier to access for first-time users. Additional benefit: it is usable on mobile phones as well and the search works quite well for those knowing what to look for. Mit freundlichen Grüßen Mirko Friedenhagen -- Am 28.10.26 um 12:26 schrieb Elliotte Rusty Harold > First impression: this feels like a marketing page, not developer > documentation. The target audience for the maven site are developers > who want to use Maven. The purpose is not to sell Maven to an > undecided audience. > > On Tue, Oct 27, 2026 at 10:56 PM Martijn Dashorst > <[email protected]> wrote: > > > > On Tue, Oct 27, 2026 at 7:59 PM Manfred Moser <[email protected]> > > wrote: > > > > > Totally agree with Elliotte. We should us our own tooling or at a > > > minimum stay with Java/JVM-based solution to keep things simpler. > > > > > > The docs source should also continue to sit with the same repos as they > > > are so we dont have to change a lot of infra and process. > > > > > > > I agree, especially since all the plugins also use doxia (if I understand > > it correctly). > > > > I don't think using doxia is a detractor for good documentation, nor a > > modern web > > design. But it might need some tweaking to enable new features, but I think > > that is > > for the better. > > > > I rebuilt my demo site using doxia, a new skin and a search index update > > all from > > maven. This version of the example is built with Maven’s own tooling: mvn > > site, > > maven-site-plugin and Doxia, from the same sources as maven.apache.org. The > > frame is a skin of its own (doxia/skin), the structure is the site > > descriptor content/site.xml, > > one menu three levels deep, and the landing pages, the news and the A–Z > > index are > > Markdown pages written from the same data by a small script. After the > > pages are > > rendered, two small classes run from the POM colour the code (Highlight) > > and write > > the search index (SearchIndex). Not in this version: the date a page last > > changed; > > moving pages to new addresses would add .htaccess redirects. The version > > built > > with Jekyll has those. > > > > You can see the results here: > > > > https://dashorst.github.io/maven-site/mvn-site/ > > > > Let me know if you have any feedback. > > > > Kind regards, > > > > Martijn Dashorst > > > > -- > Elliotte Rusty Harold > [email protected] > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
