diff --git a/docs/README b/docs/README
index f169dd14..6eff0b1e 100644
--- a/docs/README
+++ b/docs/README
@@ -1,6 +1,6 @@
 This directory contains the documentation for Smarty. All files are in docbook
-format. The top level directory contains the english docs, while the subdirs
-contain different available languages.
+format with an .sgml extention. The top level directory contains the english
+docs, while the subdirs contain different available languages.
 
 To compile the documentation, I use the docbook utilities (available as an rpm
 for redhat linux.) Compiling goes as such:
@@ -10,3 +10,6 @@ db2html -d /path/to/html.dsl manual.sgml
 
 Be sure to edit the html.dsl file and set the path to your docbook.dsl
 stylesheet file.
+
+This will create a subdirectory called manual/ which will contain the generated
+HTML docs to view with a browser.
diff --git a/docs/getting-started.sgml b/docs/getting-started.sgml
index fdf6bb5c..92931f4f 100644
--- a/docs/getting-started.sgml
+++ b/docs/getting-started.sgml
@@ -168,8 +168,8 @@ $smarty = new Smarty;</screen>
 	example, the document root is "/web/www.mydomain.com/docs/". The Smarty
 	directories are only accessed by the Smarty library and never accessed
 	directly by the web browser. Therefore to avoid any security concerns, it
-	is recommended to place these directories in a directory
-	<emphasis>off</emphasis> the document root.
+	is recommended to place these directories <emphasis>outside</emphasis> of
+	the document root.
 	</para>
 	<para>
 	For our installation example, we will be setting up the Smarty environment