From d5a0321001c88e95e04dcd7c0a90fb9d89bbe9c1 Mon Sep 17 00:00:00 2001
From: Jim Rollenhagen <jim@jimrollenhagen.com>
Date: Wed, 2 Nov 2016 10:35:53 -0400
Subject: [PATCH] Clarify ironic governance requirements and process

This documents what projects may be allowed in our governance, and the
process one must follow to add a project.

Change-Id: Iaf50a94371d51784db35a66f65106cc3bcf92cf8
---
 doc/source/dev/governance.rst | 37 +++++++++++++++++++++++++++++++++++
 doc/source/index.rst          |  1 +
 2 files changed, 38 insertions(+)
 create mode 100644 doc/source/dev/governance.rst

diff --git a/doc/source/dev/governance.rst b/doc/source/dev/governance.rst
new file mode 100644
index 0000000000..dffb877b17
--- /dev/null
+++ b/doc/source/dev/governance.rst
@@ -0,0 +1,37 @@
+.. _faq:
+
+===========================
+Ironic Governance Structure
+===========================
+
+The ironic project manages a number of repositories that contribute to
+our mission. The full list of repositories that ironic manages is available
+in the `governance site`_.
+
+.. _`governance site`: http://governance.openstack.org/reference/projects/ironic.html
+
+What belongs in ironic governance?
+==================================
+
+For a repository to be part of the Ironic project:
+
+* It must comply with the TC's `rules for a new project
+  <http://governance.openstack.org/reference/new-projects-requirements.html>`_.
+* It must not be intended for use with only a single vendor's hardware.
+  A library that implements a standard to manage hardware from multiple
+  vendors (such as IPMI or redfish) is okay.
+* It must align with Ironic's `mission statement
+  <http://governance.openstack.org/reference/projects/ironic.html#mission>`_.
+
+Lack of contributor diversity is a chicken-egg problem, and as such a
+repository where only a single company is contributing is okay, with the hope
+that other companies will contribute after joining the ironic project.
+
+Repositories that are no longer maintained should be pruned from governance
+regularly.
+
+Proposing a new project to ironic governance
+============================================
+
+Bring the proposal to the ironic `weekly meeting
+<https://wiki.openstack.org/wiki/Meetings/Ironic>`_ to discuss with the team.
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 74e5cfdb81..a899ebaaff 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -85,6 +85,7 @@ reviewers.
   :maxdepth: 1
 
   Releasing Ironic Projects <dev/releasing>
+  Ironic Governance Structure <dev/governance>
 
 
 Writing Drivers