From c922640d3f27b8f56b08a31e32bb3a21632b2af3 Mon Sep 17 00:00:00 2001
From: Gregory Haynes <greg@greghaynes.net>
Date: Mon, 6 Jul 2015 16:52:36 +0000
Subject: [PATCH] Document what our stable interfaces are

Before we do a 1.0 release, we should really document what we are
commiting to.

Change-Id: I44c62f9b1a35ace5dc7d963ab5bddc83fba4bce3
---
 doc/source/developer/index.rst             |  1 +
 doc/source/developer/stable_interfaces.rst | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 doc/source/developer/stable_interfaces.rst

diff --git a/doc/source/developer/index.rst b/doc/source/developer/index.rst
index 29f26f32..8df2c876 100644
--- a/doc/source/developer/index.rst
+++ b/doc/source/developer/index.rst
@@ -10,3 +10,4 @@ Developer Documentation
    caches
    install_types
    developing_elements
+   stable_interfaces
diff --git a/doc/source/developer/stable_interfaces.rst b/doc/source/developer/stable_interfaces.rst
new file mode 100644
index 00000000..93609f7e
--- /dev/null
+++ b/doc/source/developer/stable_interfaces.rst
@@ -0,0 +1,19 @@
+Stable Interfaces
+=================
+
+diskimage-builder and the elements provide several 'stable' interfaces for both
+developers and users which we aim to preserve during a major version release.
+These interfaces consist of:
+
+The names and arguments of the executable scripts included with
+diskimage-builder in the bin directory will remain stable.
+
+The environment variables that diskimage-builder provides for elements to use
+will remain stable.
+
+The environment variables documented in each element and the values accepted
+by these environment variables will remain stable.
+
+Required environment variables for an element will not be added.
+
+Support for build or target distributions will not be removed.