Re: cvs cleanup of publications

Alex McLintock <[email protected]> writes:

> At 09:46 24/03/03, Christian wrote:
> >At the last meeting we discussed the moving of some publications to a
> >separate module.
> 
> This all looks fine. It would be good to have more documentation about
> the included publications since

> a) It is hard to tell what is supposed to be working and what not. For
> instance I have some java errors which may be down to the way I have
> built the system, or may be because I have taken code from CVS. I just
> don't know. Please do not underestimate the value of this simple task.

The move is also supposed to help with this. The publications that are
going to stay in the lenya module are supposed to work.

> b) unipublic seems to be the main example, and yet I am confused by it
> since it is not in English. 

We would like to come up with a "default publication" as a simple best
practice example. This "default publication" will of course be in
English.

> There is a comment saying that the design templates for this are not
> to be used as an example. That is confusing to read in an
> "example". I assume the graphic design is not to be copied....

I think this comment refers to the graphic design.

> ethzmat has always been a good example for me since it was so simple.

ethzmat is suffering a little bit of bitrot. Especially with the move
to a up-to-date Cocoon there are a lot of changes that have to be
applied. We would love to keep all publications but lack the resources
to keep them all up-to-date. We accept patches of course :-).

> I think we need standard examples for all sorts of tasks - eg a
> standard forum, a standard blog, a standard newspaper, etc etc etc.

See my comment above about the "default publication".

> Sadly I am *still* not up to speed with Wyona or I would help more
> myself but the lack of documentation is holding me back .

Have you seen Felix proposal for a new documentation structure? I hope
that we can start on fleshing it out soonish. This should aleviate
some of the documentation problems.

-- 
Christian Egli       [email protected]   +41 1 272 9161
                     Wyona AG, Hardstrasse 219, CH-8005 Zurich
Open Source CMS      http://www.wyona.org http://www.wyona.com