pjfanning commented on code in PR #178: URL: https://github.com/apache/pekko-site/pull/178#discussion_r2607842730
########## src/main/paradox/version-support.md: ########## @@ -0,0 +1,52 @@ +# Version Support + +Apache Pekko uses [Semantic Versioning 2.0.0](https://semver.org/). + +Currently, the versions of the various Apache Pekko @ref:[Modules](modules.md) are fairly +closely synched up. This may not continue to be the case in future and we aim to +keep this page up to date to try to describe what versions work with each other. + +A separate but related topic is our set of [Binary Compatibility rules](https://pekko.apache.org/docs/pekko/current/common/binary-compatibility-rules.html). + +## Version 2.0.x Milestones + +We have started releasing 2.0.0 milestone releases beginning with the core Pekko +module and working through the modules that are most widely used. The milestone releases +are only for testing purposes and to facilitate library maintainers. They are not meant +to be used in production. + +Due to quite a lot of deprecated code being removed in 2.0.x, it is unlikely that libs +built against Pekko 1.x jars will work with Pekko 2.0.x. This largely depends on whether +the lib uses deprecated methods or not. The larger the code base, the more likely that +there is something that relies on a method that is removed in 2.0.x. + +## Version 1.x + +It is best to use the latest 1.x releases for all the Pekko modules out there. + +We will continue to fix bugs and upgrade dependencies when they fix issues. Until the +2.0.0 full release is ready, we may add some enhancements and they will appear in minor +releases. + +Once the Pekko 2.0.0 full release is done, we will end active development in 1.x and only +important bug fixes including security fixes will appear in new 1.x releases. Review Comment: ok - I can spell out that in some cases, the fix will be too complex or just won't work well with 1.x code base and that in those cases, we will ask users to upgrade to 2.x? -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
