incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Thomas Dudziak <tom...@gmail.com>
Subject Re: [RT] Super Simple Site Generation Tool
Date Tue, 27 Dec 2005 15:45:59 GMT
On 12/27/05, Davanum Srinivas <davanum@gmail.com> wrote:

> Example: last apachecon, Geir was trying to update geronimo.html, it
> took 30+ mins before asking for help. It took me 15+ minutes to figure
> out that geronimo.html was not being linked from any page in the web
> site. So we lost close to an hour of hackathon time trying to do
> something really simple and silly - add a line of text to the
> geronimo.html asking folks to go to the geronimo actual web site.
>
> We did get into a debate on pros and cons then and there. We
> definitely knew that if someone proposed such a measure like Leo's all
> the forrest aficionados will come out of the woodwork (like you did!)
> :)

Well, I'm no forrest aficionado at all, just a user. My comments were
rather that we should avoid creating the n'th format and tool to do
something that we already have a lot of tools for.
Btw, I would be surprised if the Geronimo site (of which I don't know
anything about) is a simple site. And this seems a good example where
input to the Forrest project can make it better.

> A simple script that required no setup and that generates the html for
> the web site with no fuss is what we want. IMHO, Forrest to put it
> mildly is a pain in the neck for a total beginner to bootstrap himself
> to do something useful.

For what it's worth, I think Henri's idea is a good one. Just let the
incubated projects write their docs in HTML and Incubator gives them a
CSS (and perhaps a coarse look-and-feel to strive for). And then use
something like Sitemesh or similar to add menus and stuff.

regards,
Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Mime
View raw message