[documentation-guide] courtesy commi

[Pete Travis]

commit 932ca6666b4abee7315609beed3513c42df1fe95
Author: Pete Travis <me at petetravis.com>
Date:   Tue Nov 22 23:14:22 2011 -0700

    courtesy commi

 en-US/docbook-demonstration.xml                    |    3 --
 en-US/docbook.xml                                  |    6 ++--
 ...book_tags-structure-block_elements-qandaset.xml |    2 +-
 ...guide-docbook_tags-structure-block_elements.xml |   22 +++++++++++++++++++-
 4 files changed, 25 insertions(+), 8 deletions(-)
---
diff --git a/en-US/docbook-demonstration.xml b/en-US/docbook-demonstration.xml
index 0568ab0..6a40a62 100644
--- a/en-US/docbook-demonstration.xml
+++ b/en-US/docbook-demonstration.xml
@@ -6,8 +6,6 @@
 <programlisting>
 <![CDATA[
 <!-- This is a comment. Visible in source, not publication. -->
-<book>
-	<part>
 		<chapter>
 			<title>Chapters need titles</title>
 			<section>
@@ -20,7 +18,6 @@
 			</section>
 		</chapter>
 	</part>
-</book>	
 ]]>						
 </programlisting>						
 				
diff --git a/en-US/docbook.xml b/en-US/docbook.xml
index 60b8098..e929f6e 100644
--- a/en-US/docbook.xml
+++ b/en-US/docbook.xml
@@ -38,7 +38,7 @@
 		<para/>
 	</section>
 	
-	<section>
+<!--	<section>
 		<title>Common DocBook Tags</title>
 		<para>In this section, we'll look at the most common DocBook XML tags
 				as accepted by <command>publican print_known</command>.  
@@ -67,13 +67,13 @@
 				<section id="sect-documentation_guide-docbook_tags-structure-basic_outline">
 					<title>Basic Docbook Structure</title>
 					<para>visual guide below</para>					
-						<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="docbook-demonstration.xml" />
 				</section>
 				
+				
 				<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sect-documentation_guide-docbook_tags-structure-block_elements.xml" />
 				
 		</section>
-	</section>	
+	</section>	-->
 	
 	<section>
 		<title>Dividing a Document into Multiple Files with XIncludes</title>
diff --git a/en-US/sect-documentation_guide-docbook_tags-structure-block_elements-qandaset.xml b/en-US/sect-documentation_guide-docbook_tags-structure-block_elements-qandaset.xml
index 3eb071e..332037f 100644
--- a/en-US/sect-documentation_guide-docbook_tags-structure-block_elements-qandaset.xml
+++ b/en-US/sect-documentation_guide-docbook_tags-structure-block_elements-qandaset.xml
@@ -35,7 +35,7 @@
 			<para>What does the code look like?</para>
 		</question>
 		<answer><label>Answer:</label>
-			<para>Like this. Recursion redacted for safety.</para>
+			<para>Like this. Recursion redacted for sanity.</para>
 		</answer>
 	</qandaentry>
 </qandaset>											
diff --git a/en-US/sect-documentation_guide-docbook_tags-structure-block_elements.xml b/en-US/sect-documentation_guide-docbook_tags-structure-block_elements.xml
index d27e240..5cd15b9 100644
--- a/en-US/sect-documentation_guide-docbook_tags-structure-block_elements.xml
+++ b/en-US/sect-documentation_guide-docbook_tags-structure-block_elements.xml
@@ -26,5 +26,25 @@
 							<para> Use them as an admonition to the reader, for additional insight that needs special consideration. Should be used sparingly, since your main copy will have most of the information the reader needs.</para>
 						</note>
 						
-						<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sect-documentation_guide-docbook_tags-structure-block_elements-qandaset.xml" />
+<programlisting>
+<![CDATA[
+<!-- This is a comment. Visible in source, not publication. -->
+<book>	
+	<part>		
+		<chapter>
+			<title>Chapters need titles</title>
+			<section>
+				<title>Sections need titles too</title>
+				<para>Content goes here</para>
+					<section>
+						<title>This section is nested</title>
+						<part>This content needs its own section</part>
+					</section>
+			</section>
+		</chapter>
+	</part>
+</book>
+]]>						
+</programlisting>						
+							
 </section>
\ No newline at end of file