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
|