Use BOM for Micrometer dependency examples in reference docs

[izeye]

This PR changes to use Micrometer version for Micrometer dependency examples in reference docs.

See gh-5093

[jonatan-ivanov]

Should we do this starting from 1.12.x?
I can take care of rebasing/back-porting if we decide so.

[shakuzen]

Yes, I think we should do it in all the Antora-based docs.

[shakuzen]

I think another option that Jonatan mentioned offline is we could go in the direction of either showing how to configure the BOM in the install snippet, or we could link to another section of the docs that talks about setting up the BOM. Then we could remove the version from individual dependency declarations and mention that it's expected to use the BOM so you don't need to declare explicit versions on dependencies. That is probably better since we do expect the version to be managed for the vast majority of users, and we do not want to encourage people to declare the version at the level of individual dependencies. @izeye would you be willing to update the pull request to that effect if you don't see any issues with that approach?

[izeye]

@shakuzen Thanks for the feedback!

Sounds good. I'll try to update this in that direction.

By the way, did you mean to apply this to 1.13.x, not to 1.12.x? 1.12.x also seems to be Antora-based although it seems to be soon to be EOLed for OSS support.

[shakuzen]

By the way, did you mean to apply this to 1.13.x, not to 1.12.x? 1.12.x also seems to be Antora-based although it seems to be soon to be EOLed for OSS support.

I should have left a comment on that. We should target and apply this to 1.12.x. I made the milestone 1.13 because we don't plan to have another OSS release of 1.12, but we haven't moved the branch to the private repository for enterprise support yet.

[izeye]

@shakuzen Thanks for the explanation!

I switched the base branch to 1.12.x and updated as suggested.

[jonatan-ivanov]

I added a polish commit (51fe189): moved the templates a level up and found a few other places where it can be used (during forward merge, we should do the same exercise).

@izeye Could you please check if these changes look ok to you?

[izeye]

@jonatan-ivanov Looks great. Thank you!

[jonatan-ivanov]

@izeye I talked to Tommy and we were thinking if it is better to have the BOM instructions in the in install section and everywhere else place a link to it. Tommy's guess was if we duplicate it everywhere, people might not understand and have duplicate BOM declarations.

I made these changes on the PR, what do you think?

[izeye]

Thanks! Looks good to me.

[shakuzen]

Looks good. I just had one suggestion on wording. Let me know what you think.