-
-
Notifications
You must be signed in to change notification settings - Fork 1.7k
docs(migration): Add TLDR to v7 migration docs #5041
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
size-limit report 📦
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is a good idea and it should cover the most important aspects. Good job!
Left some optional remarks but otherwise I think this is good to go.
MIGRATION.md
Outdated
@@ -3,6 +3,13 @@ | |||
The main goal of version 7 is to reduce bundle size. This version is breaking because we removed deprecated APIs, upgraded our build tooling, and restructured npm package contents. | |||
Below we will outline all the breaking changes you should consider when upgrading. | |||
|
|||
TL;DR if you copy & pasted the basic examples from our docs: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
TL;DR if you copy & pasted the basic examples from our docs: | |
TL;DR: If you just use basic features of Sentry (e.g. you copy & pasted the basic examples from our docs), here's what changed for you: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Totally optional but maybe something along those lines to make the intent of the TL;DR a bit clearer. WDYT?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Slightly adjusted because i didn't like the parenthesis. Let me know what you think of it now!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice, I like it. Thanks for taking another look!
Adds a tldr section at the top of the v7 migration docs for users who only have a basic installation of sentry without any advanced features.
Thought process being: "If people copy & pasted examples from our docs in the past, what do they need to do so it still works after upgrading to v7?"
Ref: https://getsentry.atlassian.net/browse/WEB-904