Skip to content

Add migration guide for v7 #4910

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 2 commits into from
Apr 11, 2022
Merged

Add migration guide for v7 #4910

merged 2 commits into from
Apr 11, 2022

Conversation

lforst
Copy link
Contributor

@lforst lforst commented Apr 11, 2022

This is adding a migration guide for migrating from 6.x to 7.x.

Currently the following changes need to be documented:

  • ES6 for CJS files
  • Dropping Support for Node v6
  • Removing Platform Integrations
  • New npm package structure
  • Deleting deprecations

Please let me know if I forgot something in the list above!

Ref:

@github-actions
Copy link
Contributor

github-actions bot commented Apr 11, 2022

size-limit report 📦

Path Size
@sentry/browser - ES5 CDN Bundle (gzipped + minified) 20.07 KB (-0.37% 🔽)
@sentry/browser - ES5 CDN Bundle (minified) 64.28 KB (-0.51% 🔽)
@sentry/browser - ES6 CDN Bundle (gzipped + minified) 18.77 KB (-0.46% 🔽)
@sentry/browser - ES6 CDN Bundle (minified) 57.67 KB (-0.52% 🔽)
@sentry/browser - Webpack (gzipped + minified) 23.05 KB (-0.82% 🔽)
@sentry/browser - Webpack (minified) 80.87 KB (-1.03% 🔽)
@sentry/react - Webpack (gzipped + minified) 23.09 KB (-0.81% 🔽)
@sentry/nextjs Client - Webpack (gzipped + minified) 47.86 KB (-0.41% 🔽)
@sentry/browser + @sentry/tracing - ES5 CDN Bundle (gzipped + minified) 26.01 KB (-0.24% 🔽)
@sentry/browser + @sentry/tracing - ES6 CDN Bundle (gzipped + minified) 24.42 KB (-0.26% 🔽)

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.

This looks overall very good to me. I think it covers everything related to the linked tasks. I just had some minor suggestions/comments which by all means are mostly optional.

**CDN bundles of version 7 or higher will no longer be distributed through our npm package.**
This means that most third-party CDNs like [unpkg](https://unpkg.com/) or [jsDelivr](https://www.jsdelivr.com/) will also not provide them.

If you depend on any specific files in a Sentry JavaScript npm package, you will most likely need to update their references.
Copy link
Member

Choose a reason for hiding this comment

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

Should we give an example of changing an import from e.g. @sentry/somePkg/dist/... to @sentry/somePkg (recommended) or @sentry/somePkg/cjs/.. (if really necessary)?

MIGRATION.md Outdated

If you depend on any specific files in a Sentry JavaScript npm package, you will most likely need to update their references.

### Removing the `API` class from `@sentry/core``
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
### Removing the `API` class from `@sentry/core``
### Removing the `API` class from `@sentry/core`

MIGRATION.md Outdated

### Restructuring Of Package Content

Up until now, we have published our packages on npm with the following structure:
Copy link
Member

Choose a reason for hiding this comment

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

Sorry for the nit but I think it's better to be specific here. Totally optional though.

Suggested change
Up until now, we have published our packages on npm with the following structure:
Up until v6.x, we have published our packages on npm with the following structure:

MIGRATION.md Outdated

### Removing the `API` class from `@sentry/core``

The internal `API` class was removed. More details can be found in the [PR that deprecated this class](https://github.com/getsentry/sentry-javascript/pull/4281). To migrate, see the following example.
Copy link
Member

Choose a reason for hiding this comment

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

Again an optional suggestion but for me it makes sense to specify that the functionality is not lost (if I understand the PRs correctly).

Suggested change
The internal `API` class was removed. More details can be found in the [PR that deprecated this class](https://github.com/getsentry/sentry-javascript/pull/4281). To migrate, see the following example.
The internal `API` class was removed in favour of functions. More details can be found in the [PR that deprecated this class](https://github.com/getsentry/sentry-javascript/pull/4281). To migrate, see the following example.

@lforst lforst requested a review from Lms24 April 11, 2022 12:01
@AbhiPrasad AbhiPrasad added this to the 7.0.0 milestone Apr 11, 2022
@AbhiPrasad
Copy link
Member

I'm gonna go ahead and merge this in so we can iterate on it as needed.

@AbhiPrasad AbhiPrasad merged commit de739c9 into 7.x Apr 11, 2022
@AbhiPrasad AbhiPrasad deleted the lforst-migration-guilde branch April 11, 2022 18:19
@lforst
Copy link
Contributor Author

lforst commented Apr 12, 2022

we kinda messed up the commit name here but whatever

lobsterkatie pushed a commit that referenced this pull request Apr 13, 2022
Documents:
- ES6 for CJS files
- Dropping Support for Node v6
- Removing Platform Integrations
- New npm package structure
- Deleting deprecations
Lms24 pushed a commit that referenced this pull request Apr 26, 2022
Documents:
- ES6 for CJS files
- Dropping Support for Node v6
- Removing Platform Integrations
- New npm package structure
- Deleting deprecations
lobsterkatie pushed a commit that referenced this pull request Apr 26, 2022
Documents:
- ES6 for CJS files
- Dropping Support for Node v6
- Removing Platform Integrations
- New npm package structure
- Deleting deprecations
lobsterkatie pushed a commit that referenced this pull request Apr 26, 2022
Documents:
- ES6 for CJS files
- Dropping Support for Node v6
- Removing Platform Integrations
- New npm package structure
- Deleting deprecations
AbhiPrasad pushed a commit that referenced this pull request May 30, 2022
Documents:
- ES6 for CJS files
- Dropping Support for Node v6
- Removing Platform Integrations
- New npm package structure
- Deleting deprecations
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.

3 participants