From 70f2d1040fc6d3bc286cbc06a8bfd733217d09cd Mon Sep 17 00:00:00 2001
From: Nico Schottelius <nico@kr.ethz.ch>
Date: Mon, 21 Mar 2011 14:38:53 +0100
Subject: [PATCH] document multi-master and multi-environment workflow

Signed-off-by: Nico Schottelius <nico@kr.ethz.ch>
---
 doc/dev/todo/niconext            |  4 ----
 doc/man/cdist-best-practise.text | 30 ++++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/doc/dev/todo/niconext b/doc/dev/todo/niconext
index d4fe1ae4..e69de29b 100644
--- a/doc/dev/todo/niconext
+++ b/doc/dev/todo/niconext
@@ -1,4 +0,0 @@
-Write cdist-best-practise:
-   - Multi master setups
-   - Different environments (production, integration, development)
-      - via version control
diff --git a/doc/man/cdist-best-practise.text b/doc/man/cdist-best-practise.text
index 4d4b8edb..af06084e 100644
--- a/doc/man/cdist-best-practise.text
+++ b/doc/man/cdist-best-practise.text
@@ -31,6 +31,36 @@ Host *
 --------------------------------------------------------------------------------
 
 
+MULTI MASTER OR ENVIRONMENT SETUPS
+----------------------------------
+If you plan to distribute cdist among servers or use different
+environments, you can do so easily with the included version
+control git. For instance if you plan to use the typical three
+environments production, integration and development, you can
+realise this with git branches:
+
+--------------------------------------------------------------------------------
+# Go to cdist checkout
+cd /path/to/cdist
+
+# Create branches
+git branch development
+git branch integration
+git branch production
+
+# Make use of a branch, for instance production
+git checkout production
+--------------------------------------------------------------------------------
+
+Similar if you want to have cdist checked out at multiple machines,
+you can clone it multiple times:
+
+--------------------------------------------------------------------------------
+machine-a % git clone git://your-git-server/cdist
+machine-b % git clone git://your-git-server/cdist
+--------------------------------------------------------------------------------
+
+
 
 SEE ALSO
 --------