give more explicit pointer to the contribute guide

[maxandersen]

I would prefer the relevant mvn commands to use/run was documented in the repo rather than "off-site" but with this there is at least a chance to discover the documentation.

[maxandersen]

relates to #29907

[quarkus-bot]

Thanks for your pull request!

The title of your pull request does not follow our editorial rules. Could you have a look?

• title should preferably start with an uppercase character (if it makes sense!)

This message is automatically generated by a bot.

[ebullient]

Just add an additional sentence or direct link to the adoc file that is in the same directory...

The pretty version is rendered on the web.. but the adoc is perfectly readable and is right there...

[maxandersen]

Just add an additional sentence or direct link to the adoc file that is in the same directory...

The pretty version is rendered on the web.. but the adoc is perfectly readable and is right there...

which adoc file? the docs folder has no such file.

[ebullient]

See the suggested edits. All of those files exist in docs/src/asciidoc.

[maxandersen]

See the suggested edits. All of those files exist in docs/src/asciidoc.

ok, so not the same folder. docs != docs/src/asciidoc :)

[maxandersen]

push update that points out the nested readme.adoc to avoid duplication and broken links.

[ebullient]

squash please.

[inoxx03]

@maxandersen thank you for the update. I spotted some typos and dropped in edit suggestions to fix. Other than that, LGTM.

[inoxx03]

Added some phrasing suggestions, too. Feel free to accept/decline them as you see fit, but please fix the typos:)

[gsmet]

Squashed and tuned some additional things.