cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stefano Mazzocchi <stef...@apache.org>
Subject Re: [RT] Cocoon from a newbie perspectivce
Date Wed, 12 Dec 2001 10:32:36 GMT
Carlos wrote:
> 
> Here are some random thoughts from someone who's just started working with
> Cocoon2 after having done some work with Cocoon1. I hope they are taken in
> the constructive spirit in which they are offered
> 
> Carlos
> 
> Configuration: I know this is in the todo list but it is very important that
> the options are clearly explained. It's taken me over a month to develop a
> subsitemap that works on my files. Perhaps it'd be a good idea to expand the
> Idiot's guide to include some more examples?

Absolutely. I don't know what many of the configurations do myself.

> Documentation on the welcome page: I've asked this before. Is it possible to
> move the documentation to the top of the page? After the first time I
> accessed the page I am more interested on the documentation than the
> examples and it's a drag to have to scroll down to find them.

I'm going to rewrite the welcome page and restructure the site a little.
You'll see this happening in the next days.
 
> Examples: If at all possible, make sure that all examples are linked to
> source code. Sometimes it does and sometimes it doesn't

well, it would be beneficial to know 'where it does not' so that we can
fix it without having to crawl the entire space.
 
> Skeleton applications: I think that it would be very beneficial for people
> who are just starting to use Cocoon to have an application where all there
> is built-in are configuration files commented as appropriate. This can be
> thought of as a best practice document as well, for it would allow people to
> see the recommended way of doing it. I know Cello is out there as a model
> application but it was very hard for me to understand how to adopt it for my
> own use.

Don't know of this "Cello". What/where is it? should we integrate it
with the distro?

> Best practices: What has worked well and what has not worked with Cocoon? I
> think this is a part of community building that is often overlooked and
> important enough to merit some effort. If there's enough interested I'm
> willing to collect tips, tricks and experiences from people and put them
> together as one file or a collection of files we can link to from the
> website

+1 on this. I'll be very happy to include it in the site if you do.

-- 
Stefano Mazzocchi      One must still have chaos in oneself to be
                          able to give birth to a dancing star.
<stefano@apache.org>                             Friedrich Nietzsche
--------------------------------------------------------------------



---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message