doc: Add ssh agent and architecture pages

Signed-off-by: Sol Jerome <solj@ices.utexas.edu>

git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@5683 ce84e21b-d406-0410-9b95-82705330c041

1 files changed, 14 insertions, 1 deletions

diff --git a/doc/client/index.txt b/doc/client/index.txt
index 7762b677c..0e67a7014 100644
--- a/doc/client/index.txt
+++ b/doc/client/index.txt
@@ -1,10 +1,23 @@
-.. client-index:
+.. -*- mode: rst -*-
+
+.. _client-index:
 
 The Bcfg2 Client
 ================
 
+The Bcfg2 client is responsible for determining what reconfiguration
+operations must be undertaken on the client, but does not perform any
+processing of the target configuration description. We chose this
+architecture, as opposed to one with a smarter client, for a few reasons:
+
+* Client failure forces administrators to perform an O(n) reconfiguration operation. Simpler code is easier to debug and maintain.
+* Minimize the bootstrap size; a complicated client can require more aspects of the system to function in order for reconfiguration to work. 
+* Isolate configuration generation functionality on the server, where it can be readily observed. This is the most complicated task that Bcfg2 performs. 
+* The results of the configuration process fit a fairly simple model. We wanted to validate it. The result is that Bcfg2 has a programmable deployment engine that can be driven by anything that writes a compatible configuration description.
+
 .. toctree::
    :maxdepth: 2
    :glob:
 
+   *
    tools/*