All Serenity/JS modules are released together, even if not all of them have changed in a given release. This is to make it easier for you to stay up to date without having to worry about any compatibility issues between the framework's modules.
The public APIs of the framework will not be removed or changed in a backward-incompatible way in minor or patch releases of the framework. However, from time to time some APIs might get marked as
When an API is marked as
@deprectated, the documentation of the API will provide instructions on what other API has superseded the deprecated one. Additionally, a ticket marked as
deprecation-notice is raised on Serenity/JS Github, and you'll have at least 3 months since the ticket is raised to migrate the code using a deprecated api to the new alternative.
Removing a deprecated API will not affect the major version number of the Serenity/JS framework.
In order to enable early feedback, from time to time experimental APIs are introduced to the framework. Those APIs are clearly marked as
When a new experimental API is introduced to the framework, a ticket marked as
experiment will be raised on Serenity/JS Github, so you're encouraged to give the idea a thumbs up or provide suggestions on how it could be improved.
Please be aware that experimental APIs might change or get removed without prior notice and without affecting the major version number of the Serenity/JS framework.