Misleading Dependency Management Documentation

[micheljung]

The Dependency Management section says:

All Google Cloud services extensions are part of the Quarkus platform, if you’re using the platform BOM (io.quarkus.platform:quarkus-bom) there is no need to manage their version.

If you’re not using the platform BOM, you can use the Google Cloud services BOM to manage all versions:

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>io.quarkiverse.googlecloudservices</groupId>
        <artifactId>quarkus-google-cloud-services-bom</artifactId>
        <version>${quarkus.google-cloud-services.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

This does not seem to be correct. quarkus-bom does not include dependency management for any of the Google cloud service libraries.
Also, when you have io.quarkus.platform:quarkus-bom and you run i.e.:

./gradlew addExtension --extensions="io.quarkiverse.googlecloudservices:quarkus-google-cloud-firebase-admin"

It'll add:

    implementation("io.quarkiverse.googlecloudservices:quarkus-google-cloud-firebase-admin")
    implementation(enforcedPlatform("io.quarkus.platform:quarkus-google-cloud-services-bom:3.30.5"))

so if quarkus-google-cloud-services-bom wasn't needed, why would it be added?

Therefore, unless I'm missing something, the documentation is incorrect and misleading.

[micheljung]

I just realized that there are:

• io.quarkiverse.googlecloudservices:quarkus-google-cloud-services-bom
• io.quarkus.platform:quarkus-google-cloud-services-bom

And that the latter is added when adding the extension. This (updated) statement seems to be correct:

All Google Cloud services extensions are part of the Quarkus platform, if you’re using the platform BOM (io.quarkus.platform:quarkus-google-cloud-services-bom) there is no need to manage their version.

But leaves me, as a user, with question marks: what's the difference, when should I use which?