search

getsentry / sentry-docs

Sentry's documentation (and tools to build it)
https://docs.sentry.io
Other
325 stars 1.41k forks source link

Deprecated SDKs migration guides #4137

Open priscilawebdev opened 2 years ago

priscilawebdev commented 2 years ago

Core or SDK?

Platform/SDK

Which part? Which one?

"What's new" broadcast

Description

Recently, some improvements have been implemented in the 'What's New' UI through the PR https://github.com/getsentry/sentry/pull/27711, making it clearer to the user which SDKs are deprecated and should be migrated and which SDKs have a new version and should be updated.

image

Deprecated SDKs are now being displayed on the top of the list with a 'deprecated' tag. Along with each alert, a link to the migration documentation is also displayed and there are two problems with this:

  1. Links from different domains are offered, as sometimes the migration documentation is only available in the repository of the new SDK. Example:

https://github.com/getsentry/sentry-javascript/blob/master/MIGRATION.md#migrating-from-raven-js-to-sentrybrowser

  1. We currently don't have a migration guide available for all deprecated raven SDKs or the migration guide is not very clear. Example:

React Native migration content is in Docs, though I don't see specific mention of Raven: https://docs.sentry.io/platforms/react-native/migration/

Suggested Solution

  1. Consolidate all migration guides on our official docs website

  2. Provide migration guide for all supported platforms

  3. Make our migration guides as clear as possible

rahulchhabria commented 1 month ago

@stephanie-anderson i think we can close this ticket since versioning should help