I recommend that we either use the standard release, incorporate the snapshot we're going to use into our CVS tree much like what appears to have been done with the DocSupport module in Webware right now.
I also find that since docutils/tools/buildhtml.py isn't installed as a part of the installation process of docutils, it makes it more difficult to automate its use. (Although if we incorporated a snapshot like we do with DocSupport, that could solve this problem.)
Other than that, I agree that the text files are easier to work in.
I am not sure we need to split off the documentation in CVS. However it might make sense to have a sourceforge package for Webware-docs similar to the Webware-devel package I created for the releases. This would allow publishing of documentation packages on an independent schedule from publishing Webware releases.
My 2-bits for now..
-Stuart-
Ian Bicking wrote:
I'd like to take out of CVS any HTML files that are derived from text
files. They really shouldn't be there anyway, but I wasn't sure if I
was going to use reST for sure... anyway, I like reST, so it would be
best if anyone working with the docs downloads docutils
(docutils.sf.net) and uses the docutils/tools/buildhtml.py script to
create the HTML.
The HTML should still be included with releases. We should also somehow
include the HTML on the website, both so people using CVS can get the
formatted version of the documentation without installing docutils, and
so people using the standard release can have the benefit of updated
documentation (which is usually not very version-specific).
Maybe documentation should be split off, so that only the InstallGuide,
maybe UserGuide, and the release notes are included with
Webware/WebKit. The rest could be in a separate module, where we could
keep documentation, tutorials, etc. Perhaps also the webware.sf.net
website.
------------------------------------------------------- This SF.NET email is sponsored by: FREE SSL Guide from Thawte are you planning your Web Server Security? Click here to get a FREE Thawte SSL guide and find the answers to all your SSL security issues. http://ads.sourceforge.net/cgi-bin/redirect.pl?thaw0026en _______________________________________________ Webware-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/webware-devel
