github.com/ydb-platform/ydb-go-sdk/v3@v3.89.2/VERSIONING.md (about)

     1  # YDB-Go-SDK Versioning Policy
     2  
     3  By adhering to these guidelines and exceptions, we aim to provide a stable and reliable development experience for our users (aka [LTS](https://en.wikipedia.org/wiki/Long-term_support)) while still allowing for innovation and improvement.
     4  
     5  We endeavor to adhere to versioning guidelines as defined by [SemVer2.0.0](https://semver.org/).
     6  
     7  We making the following exceptions to those guidelines:
     8  ## Experimental
     9     - We use the `// Experimental` comment for new features in the `ydb-go-sdk`. 
    10     - Early adopters of newest feature can report bugs and imperfections in functionality. 
    11     - For fix this issues we can make broken changes in experimental API. 
    12     - We reserve the right to remove or modify these experimental features at any time without increase of major part of version.
    13     - We want to make experimental API as stable in the future
    14  ## Deprecated
    15     - We use the `// Deprecated` comment for deprecated features in the `ydb-go-sdk`.
    16     - Usage of some entity marked with `// Deprecated` can be detected with linters such as [check-deprecated](https://github.com/black-06/check-deprecated), [staticcheck](https://github.com/dominikh/go-tools/tree/master/cmd/staticcheck) or [go-critic](https://github.com/go-critic/go-critic).
    17     - This helps to our users to soft decline to use the deprecated feature without any impact on their code.
    18     - Deprecated features will not be removed or changed for a minimum period of **six months** since the mark added.
    19     - We reserve the right to remove or modify these deprecated features without increase of major part of version.
    20  ## Internals
    21     - Some public API of `ydb-go-sdk` relate to the internals.
    22     - We use the `// Internals` comment for public internals in the `ydb-go-sdk`.
    23     - `ydb-go-sdk` internals can be changed at any time without increase of major part of version.
    24     - Internals will never marked as stable