File: version_management.md

package info (click to toggle)
azure-cli 2.82.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 2,359,416 kB
  • sloc: python: 1,910,381; sh: 1,343; makefile: 406; cs: 145; javascript: 74; sql: 37; xml: 21
file content (16 lines) | stat: -rw-r--r-- 988 bytes parent folder | download | duplicates (2) 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
 
Azure CLI Version Management
============================

## History
Azure CLI 2 was used for branding as compared to Azure classic CLI. We intended to keep the MAJOR version fixed at 2 for a while. A regular release only updated the PATCH version, which was a little confusing.

## Current Norm
Starting from version 2.1.0, Azure CLI updates:  
* MAJOR version for core changes that break commands' behavior globally;  
* MINOR version for general backward compatible feature changes and service command breaking changes;  
* PATCH version for bug fixes.

## Backward Compatibility
Considering Azure CLI is a command line tool for Azure Services, we tend to just bump the MINOR version for breaking changes in a service command module. All breaking changes for commands will be marked as **BREAKING CHANGE** in [release notes](https://learn.microsoft.com/cli/azure/release-notes-azure-cli).

At command level, packages only upgrading the PATCH version guarantee backward compatibility.