From a89f09cc1f12f5d3c069266cc68f3410257619c6 Mon Sep 17 00:00:00 2001
From: Sol Jerome <sol.jerome@gmail.com>
Date: Thu, 27 Jan 2011 08:33:54 -0600
Subject: doc: Clarify the goals of the quickstart

Signed-off-by: Sol Jerome <sol.jerome@gmail.com>
---
 doc/appendix/guides/centos.txt | 10 +++++++++-
 doc/appendix/guides/ubuntu.txt | 10 +++++++++-
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/doc/appendix/guides/centos.txt b/doc/appendix/guides/centos.txt
index b0321eebc..d89d532ba 100644
--- a/doc/appendix/guides/centos.txt
+++ b/doc/appendix/guides/centos.txt
@@ -540,7 +540,7 @@ entries to our bundle.
             <Service type='chkconfig' status='on' name='syslog'/>
     </Rules>
 
-Now we run the client and see there are no more unmanaged entries! ::
+Now we run the client and see there are no more unmanaged entries!::
 
     [root@centos ~]# bcfg2 -veqn
     Running probe groups
@@ -566,6 +566,14 @@ Now we run the client and see there are no more unmanaged entries! ::
     Total managed entries:  205
     Unmanaged entries:      0
 
+.. warning::
+
+    This basic bundle is created mainly for the purposes of getting you
+    to a completely managed client. It is recommended that you create
+    bundles for appropriate services due to the way bundle updates are
+    managed. Please see :ref:`unsorted-writing_specification` for more
+    details.
+
 Dynamic (web) reports
 =====================
 
diff --git a/doc/appendix/guides/ubuntu.txt b/doc/appendix/guides/ubuntu.txt
index 8ffda7166..e22707f2c 100644
--- a/doc/appendix/guides/ubuntu.txt
+++ b/doc/appendix/guides/ubuntu.txt
@@ -473,6 +473,14 @@ Now we run the client and see there are no more unmanaged entries! ::
 
     All entries correct.
 
+.. warning::
+
+    This basic bundle is created mainly for the purposes of getting you
+    to a completely managed client. It is recommended that you create
+    bundles for appropriate services due to the way bundle updates are
+    managed. Please see :ref:`unsorted-writing_specification` for more
+    details.
+
 Dynamic (web) reports
 =====================
 
@@ -492,4 +500,4 @@ Some Upstart services require additional parameters, like network-interface and
 .. code-block:: xml
 
     <Service name="network-interface" status="on" type="upstart" parameters="INTERFACE=eth0"/>
-    <Service name="bridge-network-interface" status="on" type="upstart" parameters="INTERFACE=br0"/>
\ No newline at end of file
+    <Service name="bridge-network-interface" status="on" type="upstart" parameters="INTERFACE=br0"/>
-- 
cgit v1.2.3-1-g7c22