sentry-docs icon indicating copy to clipboard operation
sentry-docs copied to clipboard
verified publisher icon getsentry

Add legacy banner to all raven docs

Open sl0thentr0py opened this issue 3 years ago • 2 comments

Core or SDK?

Platform/SDK

Which part? Which one?

Legacy Clients

Description

This banner is only visible on the top-level Raven docs.

image

https://docs.sentry.io/clients/

Suggested Solution

We should add the banner to all Legacy Client sub-pages.

sl0thentr0py avatar Sep 13 '22 14:09 sl0thentr0py

I wonder if we could also change the wording to include:

  • when it was deprecated (summer 2018, i.e. 4 years ago and counting)
  • the fact that large swaths of our current product can't be used if you don't upgrade
  • the fact that raven SDKs are no longer supported

"We recommend using the updated SDK for new projects" just feels not nearly opinionated enough. Some slightly nicer version of, "No, legit, dude. Upgrade now - all of your projects. Just do it. Right now. Don't read these docs. Go upgrade." feels like it's closer to what we'd actually like people to do.

lobsterkatie avatar Sep 13 '22 14:09 lobsterkatie

Perhaps we also increase the severity by saying that the Raven SDKs will not get security fixes anymore since they are deprecated and folks can easily move onto sentry-sdk versions.

AbhiPrasad avatar Sep 13 '22 15:09 AbhiPrasad

This was resolved by https://github.com/getsentry/sentry-docs/pull/7007

Screenshot 2023-06-14 at 18 00 49

stephanie-anderson avatar Jun 14 '23 16:06 stephanie-anderson