.. _extensions:

API Extensions
==============

This topic document serves to provide guidance on the topic of API extensions.

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

Guidance
--------

**TODO** Add patches that give a history of current usage of API extensions in
OpenStack projects.

**TODO** Add patches that list the issues with API extensions.

**TODO** Add a patch that makes a proposal about whether or not to recommend
use of API extensions.