Upgrading Fleet > Compatibility: Add note about changing defaults (#42014)

This commit is contained in:
Rachael Shaw 2026-03-18 17:15:40 -05:00 committed by GitHub
parent bfa274f1aa
commit f7c1e52689
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -82,6 +82,7 @@ Fleet follows [Semantic Versioning (SemVer)](https://semver.org/). This means th
+ **Experimental features:** [Experimental features](https://fleetdm.com/handbook/company/product-groups#experimental-features) are tagged as such in the API documentation. These features are being rapidly iterated on and are not for use in automated workflows.
+ **Security:** Fleet reserves the right to make breaking changes for security. When no alternative solution is available, security fixes may introduce backward-incompatible changes.
+ **Changes to default values**: Fleet occasionally changes defaults to improve stability or usability. These changes are made thoughtfully and often come from customer feedback (e.g. default SSO session validity is too short, need to increase the window) or as a bug fix (e.g. default pagination causes a timeout, need to decrease the default per-page). Any changes to defaults are weighed carefully against the possibility of breaking existing workflows.
In each of these cases, breaking changes are clearly communicated in the version notes.