kanidm/project_docs/RELEASE_AND_SUPPORT.md

50 lines
1.7 KiB
Markdown
Raw Normal View History

2020-06-30 06:58:35 +02:00
## Release Schedule
In the alpha phase, Kanidm will be released on a 3 month (quarterly) basis,
2020-06-30 06:58:35 +02:00
starting on July 1st 2020.
2022-05-01 05:55:21 +02:00
* February 1st
* May 1st
* August 1st
* November 1st
2020-06-30 06:58:35 +02:00
2022-05-01 05:55:21 +02:00
Releases will be tagged and branched in git.
2020-06-30 06:58:35 +02:00
1.2.0 will be released as the first supported version once the project believes the project is
in a maintainable longterm state, without requiring backward breaking changes. There is no current
estimated date for 1.2.0.
## Support
Releases during alpha will not recieve fixes or improvements once released, with the exception of:
* Major security issues
2022-05-01 05:55:21 +02:00
* Flaws leading to dataloss or corruption
* Other fixes at the discrestion of the project team
2020-06-30 06:58:35 +02:00
2022-05-01 05:55:21 +02:00
In the case these issues are found, an out of band alpha snapshot will be made based on the current
stable branch.
2020-06-30 06:58:35 +02:00
Alpha releases are "best effort", and are trial releases, to help get early feedback and improvements
from the community, while still allowing us to make large, breaking changes that may be needed.
2021-03-25 01:34:29 +01:00
## API stability
There are a number of "surfaces" that can be considered as "API" in Kanidm.
* JSON HTTP end points of kanidmd
2022-05-01 05:55:21 +02:00
* unix domain socket API of `kanidm_unixd` resolver
* LDAP interface of kanidm
2021-03-25 01:34:29 +01:00
* CLI interface of kanidm admin command
2022-05-01 05:55:21 +02:00
* Many other interaction surfaces
2021-03-25 01:34:29 +01:00
2022-05-01 05:55:21 +02:00
During the Alpha, there is no guarantee that *any* of these APIs named here or not named will remain stable.
Only elements from "the same release" are guaranteed to work with each other.
2021-03-25 01:34:29 +01:00
2022-05-01 05:55:21 +02:00
Once an official release is made, only the JSON API and LDAP interface will be declared stable.
The unix domain socket API is internal and will never be "stable".
The CLI is *not* an API and can change with the interest of human interaction during any release.
2021-03-25 01:34:29 +01:00