I have added a date on my calendar for another beta cut, presently
September 7 depending on work loads. I would greatly appreciate help in
addressing the issues raised by Christoph.
I have notes for changes to ReleaseProcedures.html, and I can clean the
.cvsignore files out easily enough when I build up the next beta cut.
Help is needed with other items on his list...
Webware/Docs/StyleGuidelines.raw
Webware/bin/MakeAppWorkDir.py
Webware/bin/pystats.py
Webware/bin/ReleaseHelper.py
Volunteers are most welcome.
- Mark
On Jul 31, 2005, at 7:18 PM, Christoph Zwerschke wrote:
I went through most of the Webware toplevel doco today and checked in
lots of html cleanup and cosmetic improvements (I hope it's ok to do
this directly in the trunk, since it can hardly break anything).
Actually, the whole documentation creation process should be
overhauled. Currently it's very patchy with a lot of different tools
and obscure automagic. There's the ".htmlf" header/footer fragment
processing and there are ".raw" templates which are actually only used
for one single page of the doco (the style guidelines). The htmlf/raw
do not mix. There are also other pages that are not processed at all.
And there are even pages which do not have a proper head and body
section, e.g. ClassList.html. In the long run, I think we would do
good to change over to a consistent documentation creation process
throughout Webware, using one of Webware's featured templating
languages such as PSP or Kid.
I also noticed that there are still a lot of references to CVS as
opposed to SVN, for instance in:
Webware/Docs/StyleGuidelines.raw
Webware/Docs/ReleaseProcedures.html
.cvsignore files everywhere
Webware/bin/MakeAppWorkDir.py
Webware/bin/pystats.py
Webware/bin/ReleaseHelper.py
Maybe somebody who knows more about the release procedures and
migration to SVN can adjust these things and get rid of the CVS
reminiscences.
-- Christoph
-------------------------------------------------------
SF.Net email is Sponsored by the Better Software Conference & EXPO
September 19-22, 2005 * San Francisco, CA * Development Lifecycle Practices
Agile & Plan-Driven Development * Managing Projects & Teams * Testing & QA
Security * Process Improvement & Measurement * http://www.sqe.com/bsce5sf
_______________________________________________
Webware-devel mailing list
Webware-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/webware-devel
