Hi Ondrej,

about your "more hands-on approach". We discussed this and decided to wrote the different articles with different personas as the main targeting audience, see:

https://github.com/support-and-care/doc-for-maven/blob/main/writing-guide.md

Does this cover your preferences?

> These days, will anybody read a full page of documentation? Save for an AI scraper? I doubt that.

I can remove your doubt. I will read a full page of good written documentation, because I want to learn it and not trust a summary mixed by whatever sources.

Matthias

Am 23.10.2026 um 11:36 schrieb Ondřej Světlík:
Dear Sandra,

making Maven more accessible is a good task. The documentation really looks "modern". But it feels old. The same structure as everything else. Prerequisites. Whole pages of fluff to read through. Maybe it's my neurodivergent brain, but I personally prefer a more hands-on approach. Wanna see what Maven can do?
* git clone
* ./mwnw
* observe, explore
* there's a README.md with ways you can expand this example

These days, will anybody read a full page of documentation? Save for an AI scraper? I doubt that.

Regards,
Ondřej

---------------------------------------------------------------------
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]

Reply via email to