[generguide-devel] More User Guide Comments

[Cameron S. <ca...@sh...>]

Obtaining a Working Copy:
The prefered download will be to download a zip file.
This will be available from: http://sourceforge.net/projects/generguide/ 
I've put version 0.1 there, 0.2 will be there as soon as we have finished the 
docs.
--
I don't think that downloading source via CVSView should be recommended by the 
guide.  It is a very messy way to download the project.
--
Package Folders:
docbook-xsl/ directory has been deprecated.  We now import the directory into 
lib/docbook-xsl/ using bin/install-libs.sh .
--
Local Installation:
Step 4: install-libs.sh is not required as we will package up the libs in the 
prepackaged .zip file.
Let's keep installation as easy as possible.
--
Making Generic Documents:
You note that the root element of a document may be any sdocbook element.  
This should be the case, however we have taken short cuts in the XSLT and 
have only supported "section" and "article" elememts as the root element.
--
External Entities:
It is worth noting that we are considering alternatives to replace our use of 
Entities.
--
Markup Practices & Structure:
Both have included "Section Structure"
--
Configuration:
generguide/baseurl is not used.
--
Generguide Reference/Entity Reference Development:
I think we should remove this section.  Entities will be different for each 
project and we should point at the entity.ent file for people to reference 
instead.

-- 
Cameron Shorter              http://cameron.shorter.net
Open Source Developer        http://generguide.sourceforge.net
                             http://mapbuilder.sourceforge.net
                             http://geotools.org
Senior Software Engineer     http://www.adi-limited.com