Documentation is not updated

[newur]

Hello,

there is a difference between the latest public docu and the content of the .adoc files on github.

For instance I checked

• https://quarkus.io/guides/rabbitmq-dev-services and it misses the part about the Management UI as desribed here https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/rabbitmq-dev-services.adoc#access-the-management-ui
• https://quarkus.io/guides/databases-dev-services misses the new part about how to connect to the database as described here https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/databases-dev-services.adoc#connect-to-database-run-as-a-dev-service

So I assume the docu in general was not updated?

Side note: I think the new feature introduced during #25289 misses any mention in the docu?! Maybe the new command property should be explained with an example on https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/databases-dev-services.adoc ? Right now it is rather hard to find in the Configuration Reference section...

/update
I messed up the branch selection during PR creation. Sorry about that.

[quarkus-bot]

/cc @Sanne, @brunobat, @gsmet, @loicmathieu, @radcortez, @yrodiere

[geoand]

The documentation on the website should match the source found in the 2.11.1.Final tag. Can you check please?

[yrodiere]

It is true that the documentation on the website is not up-to-date. @gsmet is it a known release problem?

EDIT: See for example https://github.com/quarkusio/quarkus/blob/2.11/docs/src/main/asciidoc/rabbitmq-dev-services.adoc#access-the-management-ui, that section is missing at https://quarkus.io/guides/rabbitmq-dev-services, despite being introduced in 2.11.0.CR1: 516230f

---

Regardless, this PR is not necessary as all the relevant changes have already been backported:

https://quarkus.io/guides/rabbitmq-dev-services and it misses the part about the Management UI as desribed here https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/rabbitmq-dev-services.adoc#access-the-management-ui

It's already in 2.11: https://github.com/quarkusio/quarkus/blob/2.11/docs/src/main/asciidoc/rabbitmq-dev-services.adoc#access-the-management-ui

https://quarkus.io/guides/databases-dev-services misses the new part about how to connect to the database as described here https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/databases-dev-services.adoc#connect-to-database-run-as-a-dev-service

It's already in 2.11: https://github.com/quarkusio/quarkus/blob/2.11/docs/src/main/asciidoc/databases-dev-services.adoc#connect-to-database-run-as-a-dev-service

Side note: I think the new feature introduced during #25289 misses any mention in the docu?! Maybe the new command property should be explained with an example on https://github.com/quarkusio/quarkus/blob/main/docs/src/main/asciidoc/databases-dev-services.adoc ? Right now it is rather hard to find in the Configuration Reference section...

As you pointed out, the configuration property is documented in the configuration reference. The argument "it's hard to find" is hardly valid: if we accepted it, it would only lead to adding a section about every single configuration property, regardless of how exotic/rarely used it is, and then what's the point of the configuration reference? We can only reasonably add a section for the most important properties; I can't personally say whether this one is important enough, but others will probably chime in.

In any case, that's unrelated to the problem at hand: please open a separate issue/pull request so that you can have that discussion.

Though obviously it's not in 2.11, but that's the same problem as the other pieces of documentation.

[gsmet]

The documentation publication script got broken here: 086c7bb#diff-d00c67fd13e9b811f6decf2a12b17ab690e3ff209c5712331d631d739c1a6657R12 .

Thanks for raising the issue, I will republish everything. But this PR is doing nothing good. Closing it.