Include design documentation

doc/conf.py

@@ -38,6 +38,7 @@ extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.viewcode',
     'sphinx.ext.githubpages',
+    'recommonmark',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -68,6 +69,12 @@ html_theme = 'alabaster'
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
+# -- Options for sources -----------------------------------------------------
+
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
 
 # -- Extension configuration -------------------------------------------------
 

doc/designs/index.rst

@@ -0,0 +1,14 @@
+FreeIPA design documentation
+============================
+
+.. toctree::
+   :maxdepth: 1
+
+   adtrust/oneway-trust-with-shared-secret.md
+   adtrust/samba-domain-controller.md
+   adtrust/samba-domain-member.md
+   krb-ticket-policy.md
+   extdom-plugin-protocol.md
+   membermanager.md
+   hidden-replicas.md
+   disable-stale-users.md

doc/index.rst

@@ -28,6 +28,7 @@ installation and configuration tasks.
    :maxdepth: 2
    :caption: Contents:
 
+   designs/index.rst
 
 
 Indices and tables