Skip to content

Commit f697d7f

Browse files
authored
docs: Update Versions file to update communication about releases (#1959)
1 parent c0c0647 commit f697d7f

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

VERSIONS.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,16 @@ When a new feature set comes online or a small breaking change is introduced, th
99

1010
The MAJOR version is used to indicate the family of technology represented by the library. Breaking changes that require extensive reworking of code will cause the MAJOR version to be incremented by one, and the MINOR and PATCH versions will be reset to zero. Since frequent major updates can be very disruptive, we will only introduce this type of breaking change when absolutely necessary.
1111

12-
New MAJOR versions will be communicated in advance via:
12+
## Support lifecycle
1313

14-
* Box SDK documentation, such as API reference documentation, user guides, SDK product marketing pages, and GitHub readme(s) are updated to indicate the campaign timeline and provide guidance on upgrading affected applications.
15-
* Deprecation warnings are added to the SDKs, outlining the path to end-of-support and linking to the SDK documentation.
14+
Each Box SDK README publishes a **[Version schedule](README.md#version-schedule)** table. That table is the source of truth for which **major versions** are **Supported**, when each was first released, and when each reaches **end of life (EOL)**.
15+
16+
After a major version reaches EOL it no longer receives new features, bug fixes, or security patches. Existing applications that pin that version continue to run, but you should plan to upgrade. The version is then marked `EOL` in the README schedule.
17+
18+
Major version releases, breaking changes, and EOL dates are announced through public channels via:
19+
20+
- Box developer documentation, such as the API reference, user guides, and GitHub READMEs.
21+
- Deprecation warnings are added to the SDKs, outlining the path to end-of-support and linking to the SDK documentation.
1622

1723
Deprecations are introduced in minor releases. We will not introduce new deprecations in patch releases. These deprecations will preserve the existing behaviour while emitting a warning that provide guidance on:
1824

0 commit comments

Comments
 (0)