From 8648b7a55d77d1479edccf10c1b859cafeeb7414 Mon Sep 17 00:00:00 2001
From: Tommi Virtanen <tommi.virtanen@dreamhost.com>
Date: Tue, 20 Sep 2011 15:59:07 -0700
Subject: [PATCH] doc: Move recommendations under /rec.

Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
---
 doc/index.rst                   |  1 +
 doc/ops/index.rst               |  3 ---
 doc/ops/misc.rst                | 14 --------------
 doc/rec/crypto.rst              |  7 +++++++
 doc/{ops => rec}/filesystem.rst |  0
 doc/{ops => rec}/hardware.rst   |  3 ---
 doc/rec/index.rst               | 15 +++++++++++++++
 7 files changed, 23 insertions(+), 20 deletions(-)
 delete mode 100644 doc/ops/misc.rst
 create mode 100644 doc/rec/crypto.rst
 rename doc/{ops => rec}/filesystem.rst (100%)
 rename doc/{ops => rec}/hardware.rst (78%)
 create mode 100644 doc/rec/index.rst

diff --git a/doc/index.rst b/doc/index.rst
index d3ad0c669ec..588c47b8580 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -89,6 +89,7 @@ Table of Contents
    tutorial
    architecture
    ops/index
+   rec/index
    api/index
    Internals <dev/index>
    man/index
diff --git a/doc/ops/index.rst b/doc/ops/index.rst
index 3bc4dbaabe1..2fd9e7ed73c 100644
--- a/doc/ops/index.rst
+++ b/doc/ops/index.rst
@@ -9,9 +9,6 @@
    config
    radosgw
    rbd
-   hardware
-   filesystem
    monitor
    data-placement
    autobuilt
-   misc
diff --git a/doc/ops/misc.rst b/doc/ops/misc.rst
deleted file mode 100644
index 084debc80e7..00000000000
--- a/doc/ops/misc.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-===============
- Miscellaneous
-===============
-
-.. todo:: This section should not exist. Try to reorganize, when
-   document is otherwise more ready.
-
-
-Disabling encryption
-====================
-
-Authentication is optional but very much recommended.
-
-.. todo:: write me
diff --git a/doc/rec/crypto.rst b/doc/rec/crypto.rst
new file mode 100644
index 00000000000..6fe7d858d53
--- /dev/null
+++ b/doc/rec/crypto.rst
@@ -0,0 +1,7 @@
+========================
+ Disabling cryptography
+========================
+
+Authentication is optional but very much recommended.
+
+.. todo:: write me
diff --git a/doc/ops/filesystem.rst b/doc/rec/filesystem.rst
similarity index 100%
rename from doc/ops/filesystem.rst
rename to doc/rec/filesystem.rst
diff --git a/doc/ops/hardware.rst b/doc/rec/hardware.rst
similarity index 78%
rename from doc/ops/hardware.rst
rename to doc/rec/hardware.rst
index a3c5872d019..7cc5506fbd1 100644
--- a/doc/ops/hardware.rst
+++ b/doc/rec/hardware.rst
@@ -2,9 +2,6 @@
  Hardware recommendations
 ==========================
 
-Hardware requirements and tradeoffs
-===================================
-
 Discussing the hardware requirements for each daemon, the tradeoffs of
 doing one cosd per machine versus one per disk, and hardware-related
 configuration options like journaling locations.
diff --git a/doc/rec/index.rst b/doc/rec/index.rst
new file mode 100644
index 00000000000..0b1e6154ef7
--- /dev/null
+++ b/doc/rec/index.rst
@@ -0,0 +1,15 @@
+=================
+ Recommendations
+=================
+
+There are several ways to set up a storage system. Often, the nature
+of the load means different tradeoffs make sense for different
+installations. This section aims to walk through some common
+scenarios, and inform you on how to decide what is best for your
+cluster.
+
+.. toctree::
+
+   hardware
+   filesystem
+   crypto