diff --git a/docs/README.txt b/docs/README.txt
index b922bb8deaa..f8b420f5e9a 100644
--- a/docs/README.txt
+++ b/docs/README.txt
@@ -37,6 +37,10 @@ VALID XML TAGS
Certain tags are disallowed by Publican. Please consult their documentation for more details.
http://jfearn.fedorapeople.org/en-US/Publican/2.7/html/Users_Guide/
+Your best bet is to copy an existing XML file and fill in your own content between the tags.
+
+At the bottom of this README, there is a fill-in-the-blanks XML template that you can go from. It shows the commonly used tags and explains a bit about how to use them.
+
----------------------------------
@@ -117,4 +121,161 @@ CONTRIBUTING
----------------------------------
-Contributors can create new section, chapter, book, publican.cfg, or localized .xml files at any time. Submit them following the same patch approval procedure that is used for contributing to CloudStack code. More information for contributors is available at https://cwiki.apache.org/confluence/display/CLOUDSTACK/Documentation+Team.
\ No newline at end of file
+Contributors can create new section, chapter, book, publican.cfg, or localized .xml files at any time. Submit them following the same patch approval procedure that is used for contributing to CloudStack code. More information for contributors is available at https://cwiki.apache.org/confluence/display/CLOUDSTACK/Documentation+Team.
+
+----------------------------------
+
+TAGS FOR A SECTION
+----------------------------------
+
+
+
+%BOOK_ENTITIES;
+]>
+
+
+
+
+
+
+
+ Text of the section title
+ Here’s the text of a paragraph in this section.
+ Always use &PRODUCT; rather than typing CloudStack or CloudPlatform.
+ Indent with 4 spaces, not with tab characters.
+ To hyperlink to a URL outside this document: Display text of the link here
+ To hyperlink to another section in this document:
+ The publication tools will automatically insert the display text of the link for you.
+ Use this for all tips and asides. Don’t use other tags such as tip.
+ Our publication tool (publican) prefers the note tag. The tool will
+ automatically insert the text NOTE: for you, so please don’t type it.
+ Use this for anything that is vital to avoid runtime errors. Don’t use
+ other tags such as caution. Our publication tool (publican) prefers the warning tag. The tool will
+ automatically insert the text WARNING: for you, so please don’t type it.
+ Here’s how to do a bulleted list:
+
+ Bulleted list item text.
+
+ Here’s how to do a numbered list. These are used for step by step instructions
+ or to describe a sequence of events in time. For everything else, use a bulleted list.
+
+ Text of the step
+ You might also want a sub-list within one of the list items. Like this:
+
+ Inner list item text.
+
+
+
+ Here’s how to insert an image. Put the graphic file in images/, a subdirectory of the directory where this XML file is.
+ Refer to it using this tag. The tag is admittedly complex, but it’s the one we need to use with publican:
+
+
+
+
+ YOUR_FILENAME_HERE.png: Alt text describing this image, such as
+ “structure of a zone.” Required for accessibility.
+
+ A section can contain sub-sections. Please make each sub-section a separate file to enable reuse.
+ Then include the sub-section like this:
+
+
+
+
+
+----------------------------------
+
+TAGS FOR A CHAPTER
+----------------------------------
+
+
+
+%BOOK_ENTITIES;
+]>
+
+
+
+
+
+
+
+ Text of the chapter title
+
+
+
+
+
+
+----------------------------------
+
+TAGS FOR A BOOK
+----------------------------------
+
+
+
+%BOOK_ENTITIES;
+]>
+
+
+
+
+
+
+
+
+
+
+
+
+----------------------------------
+
+BASIC RULES FOR INCLUDE STATEMENTS
+----------------------------------
+
+A book file must include chapter files.
+A chapter file must include section files.
+A section file can include other section files, but it doesn't have to.