svn commit: r408784 - /forrest/trunk/site-author/content/xdocs/procedures/How_to_publish_docs.xml

[cr...@apache.org]

Author: crossley
Date: Mon May 22 16:10:24 2006
New Revision: 408784

URL: http://svn.apache.org/viewvc?rev=408784&view=rev
Log:
Enhance the note about validation.

Modified:
    forrest/trunk/site-author/content/xdocs/procedures/How_to_publish_docs.xml

Modified: forrest/trunk/site-author/content/xdocs/procedures/How_to_publish_docs.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/procedures/How_to_publish_docs.xml?rev=408784&r1=408783&r2=408784&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/procedures/How_to_publish_docs.xml (original)
+++ forrest/trunk/site-author/content/xdocs/procedures/How_to_publish_docs.xml Mon May 22 16:10:24 2006
@@ -50,9 +50,14 @@
                 
                 
                 # Make changes to sources, and then test, then commit.
+                # Best to wait on committing the source changes until
+                # you have built and reviewed the docs.
 
                 # Please, please, ensure valid xml docs. Errors will be
                 # reported during the 'build' phase if you don't.
+                # Also it prevents other people from working with the docs,
+                # which goes against the collaborative development process.
+
                 # You can do 'forrest validate-xdocs" beforehand or use
                 # a validating editor (link: catalog.html) or for a single doc use
                 # xmllint (link: catalog.html) from the command-line, e.g.