.. _compatibility:

Compatibility
=============

This topic document serves to provide guidance on how to handle proposed
changes to a public REST API.

See also the topic document on :ref:`discoverability`.

Guidance
--------

**TODO** Take pieces from https://wiki.openstack.org/wiki/APIChangeGuidelines
and add them to this topic document, one at a time, in separate patches.