Skip to content

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

Merged
merged 4 commits into from
May 5, 2022
Merged

docs(migration): Add TLDR to v7 migration docs #5041

merged 4 commits into from
May 5, 2022

Conversation

lforst
Copy link
Contributor

@lforst lforst commented May 5, 2022

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

@lforst lforst requested review from Lms24, AbhiPrasad, lobsterkatie and HazAT and removed request for Lms24 and AbhiPrasad May 5, 2022 11:15
@github-actions
Copy link
Contributor

github-actions bot commented May 5, 2022

size-limit report 📦

Path Size
@sentry/browser - ES5 CDN Bundle (gzipped + minified) 18.72 KB (-7.03% 🔽)
@sentry/browser - ES5 CDN Bundle (minified) 58.51 KB (-9.45% 🔽)
@sentry/browser - ES6 CDN Bundle (gzipped + minified) 17.53 KB (-7.04% 🔽)
@sentry/browser - ES6 CDN Bundle (minified) 52.69 KB (-9.11% 🔽)
@sentry/browser - Webpack (gzipped + minified) 19.2 KB (-17.38% 🔽)
@sentry/browser - Webpack (minified) 62.07 KB (-24.05% 🔽)
@sentry/react - Webpack (gzipped + minified) 19.22 KB (-17.43% 🔽)
@sentry/nextjs Client - Webpack (gzipped + minified) 42.9 KB (-10.74% 🔽)
@sentry/browser + @sentry/tracing - ES5 CDN Bundle (gzipped + minified) 24.5 KB (-6.06% 🔽)
@sentry/browser + @sentry/tracing - ES6 CDN Bundle (gzipped + minified) 23.08 KB (-5.74% 🔽)

Copy link
Member

@Lms24 Lms24 left a 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:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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:

Copy link
Member

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?

Copy link
Contributor Author

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!

Copy link
Member

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!

@lforst lforst requested a review from Lms24 May 5, 2022 12:36
@lforst lforst force-pushed the lforst-v7-tldr branch from 15e9064 to 88dbdfc Compare May 5, 2022 12:40
@lforst lforst merged commit 419416a into 7.x May 5, 2022
@lforst lforst deleted the lforst-v7-tldr branch May 5, 2022 12:41
@lforst lforst added this to the 7.0.0 milestone May 5, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants