Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


CategoryValid alternateFocus

enterprise change

enterpriseChanges to CockroachDB features requiring an enterprise license, e.g., BACKUP/RESTORE.
ops changeoperational change

Changes to cockroach commands that affect primarily operators tasked with setting up and maintaining production clusters.

This includes changes to logging configurations and behavior, environment variables, integrations with service managers, CLI flags for server commands, exit codes, etc.

cli changecli

Changes to cockroach commands that affect primarily application developers, CockroachDB developers and contributors, and operators running experiments or small-scale testing/staging clusters.

This includes changes to the SQL shells, userfileworkloaddebug commands that operate on non-running servers, etc.

sql changesqlChanges to SQL statements, functions/operators, or execution.
api changeapiChanges to /wiki/spaces/ENG/pages/856851129, including classification and versioning.
admin ui changeuiChanges to the Admin UI or any associated endpoints.
security update


security change

Changes that impacts the use of security features (IAM, TLS, etc.) or the security profile of the product. 
performance improvement


performance change

Changes that improve performance, often at kv, storage, and SQL engine levels.
bug fixbugfixChanges that fix known problems as opposed to add or improve functionality.
general change


core change

Changes that don't fit anywhere else. Only use this if you have no other good option. This might include changes to logs and user-facing configs for Kubernetes, Prometheus, Alertmanager, etc. We probably need new, meaningful categories. 
build change
Changes to requirements for building CockroachDB from source.
backward-incompatible changebackwards-incompatible change

Changes that can break programmatic usage of an interface. This will be defined more clearly soon because not all interfaces are programmable, but examples are when an interface is remove, stops accepting a certain syntax or values, or has a new default value. See past examples.