By adhering to these guidelines and exceptions, we aim to provide a stable and reliable development experience for our users (aka LTS) while still allowing for innovation and improvement.
We endeavor to adhere to versioning guidelines as defined by SemVer2.0.0.
We making the following exceptions to those guidelines:
- We use the
// Experimentalcomment for new features in theydb-go-sdk. - Early adopters of newest feature can report bugs and imperfections in functionality.
- For fix this issues we can make broken changes in experimental API.
- We reserve the right to remove or modify these experimental features at any time without increase of major part of version.
- We want to make experimental API as stable in the future
- We use the
// Deprecatedcomment for deprecated features in theydb-go-sdk. - Usage of some entity marked with
// Deprecatedcan be detected with linters such as check-deprecated, staticcheck or go-critic. - This helps to our users to soft decline to use the deprecated feature without any impact on their code.
- Deprecated features will not be removed or changed for a minimum period of six months since the mark added.
- We reserve the right to remove or modify these deprecated features without increase of major part of version.
- Some public API of
ydb-go-sdkrelate to the internals. - We use the
// Internalscomment for public internals in theydb-go-sdk. ydb-go-sdkinternals can be changed at any time without increase of major part of version.- Internals will never marked as stable