Java: Add BOM docs.

[maciejwalkowiak]

Closes #3652

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/sentry/sentry-docs/CCjxxms1pHFDJhE56xjN3eB1LGy6
✅ Preview: https://sentry-docs-git-fork-maciejwalkowiak-gh-3652.sentry.dev

[maciejwalkowiak]

Perhaps there is a better way to include this piece into every Java guide?

[maciejwalkowiak]

cc @marandaneto @bruno-garcia

[maciejwalkowiak]

I am not 100% convinced that this is the right place to put BOM docs. AFAIR we aimed "Getting Started" for having only essential information - BOM docs are useful only if more than one Sentry dependency is used (Android + Coroutines, Spring + Logback etc).

[marandaneto]

I am not 100% convinced that this is the right place to put BOM docs. AFAIR we aimed "Getting Started" for having only essential information - BOM docs are useful only if more than one Sentry dependency is used (Android + Coroutines, Spring + Logback etc).

based on my comment here #3652 (comment)
I'd say its best to be within the install step, so here most of the cases -> https://github.com/getsentry/sentry-docs/tree/master/src/includes/getting-started-install

if the install steps don't include 2 dependencies or more, we don't add the bom, but rather to the integrations or guides that do, eg https://github.com/getsentry/sentry-docs/blob/master/src/platforms/android/configuration/integrations/fragment.mdx
we'd just need to find all the files that add 2 or more dependencies, and update them to use the bom

[maciejwalkowiak]

I see a scenario where users uses Spring and Logback - there is no dedicated page for this combination, and there wouldn't be a place to put BOM docs.

What about having a separate section "Using BOM" or "Managing Dependencies" somewhere in the main menu:

[marandaneto]

I see a scenario where users uses Spring and Logback - there is no dedicated page for this combination, and there wouldn't be a place to put BOM docs.

What about having a separate section "Using BOM" or "Managing Dependencies" somewhere in the main menu:

that makes sense, not sure how the BOM word is known, but something related to Dependencies makes sense to me.

[maciejwalkowiak]

@marandaneto updated.

[bruno-garcia]

I think this is something @PeloWriter and @marandaneto might have thoughts but if they are happy with it, it also LGTM

One question/suggestion about Android.
Another detail is to possibly not have it as a top level item. Maybe add under configuration?

[maciejwalkowiak]

@PeloWriter @marandaneto @bruno-garcia please take another look.

[bruno-garcia]

👍

[bruno-garcia]

@maciejwalkowiak seems we didn't ship bom yet though: https://github.com/getsentry/sentry-java/pull/1486/files

I jumped the gun here by merging this, should I revert?

[maciejwalkowiak]

@bruno-garcia I believe it should be reverted, and merged only once BOM PR is merged and 5.1.0 is released.

[bruno-garcia]

Raised #3939

[bruno-garcia]

Draft to add this back once 5.1.0 is out: #3940