Skip to content
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

Added breaking change definition #630

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Added breaking change definition #630

wants to merge 5 commits into from

Conversation

mcastany
Copy link
Contributor

@mcastany mcastany commented Jan 31, 2025

Motivation / Description

A customer complained about us adding a new property to our API and their app breaking. This should protect us in case of future cases

Changes introduced

Add our definition of a backwards compatible change

Linear ticket (if any)

Additional comments

Copy link

Preview this PR here: https://dev-docs.revenuecat.com/pr-630/

@mcastany mcastany changed the title [Do not merge] Added breaking change definition Added breaking change definition Jan 31, 2025
@mcastany mcastany marked this pull request as ready for review January 31, 2025 21:39
@mcastany mcastany requested a review from a team as a code owner January 31, 2025 21:39
- Versioning: Breaking changes may be introduced in new major versions of our SDKs or API versions, ensuring that existing implementations continue to function as expected.
- Migration Guides: We provide clear upgrade paths and documentation to help developers adapt to changes.

Our goal is to minimize disruptions while ensuring RevenueCat continues to evolve and improve. If you have any concerns about a potential breaking change, please reach out via our support channels or check our changelog for the latest updates.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Our goal is to minimize disruptions while ensuring RevenueCat continues to evolve and improve. If you have any concerns about a potential breaking change, please reach out via our support channels or check our changelog for the latest updates.
Our goal is to minimize disruptions while ensuring RevenueCat continues to evolve and improve. If you have any concerns about a potential breaking change, please reach out via [our support channels](https://app.revenuecat.com/settings/support) or check our changelog for the latest updates.

Copy link
Contributor

Choose a reason for hiding this comment

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

Also I got into hot water when I mentioned the changelog to Outlier and he said "what changelog" and I didn't have a great answer for him. We have release notes but it doesn't include all API changes, neither does the community or email newsletter. Should we just remove "check our changelog"?


Our goal is to minimize disruptions while ensuring RevenueCat continues to evolve and improve. If you have any concerns about a potential breaking change, please reach out via our support channels or check our changelog for the latest updates.

For further clarification or to discuss how a change might impact your integration, feel free to contact us!
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
For further clarification or to discuss how a change might impact your integration, feel free to contact us!
For further clarification or to discuss how a change might impact your integration, feel free to [contact us](https://app.revenuecat.com/settings/support)!

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