So we can repurpose the xdoc material w/ m2? (Meaning when we get
over to m2, we can regen the site with that?)
geir
On Jun 8, 2005, at 10:25 PM, Jason van Zyl wrote:
On Tue, 2005-06-07 at 11:37 -0700, David Blevins wrote:
I didn't mean to be the deciding vote, I'd still like to know what
others think. We haven't heard from very many people on this thread.
Hey everyone out there who has ever had an opinion on the website,
what do you think?
Again, I'm talking to everyone, not just people privileged with
commit access. Speak up :)
I'm not volunteering to do you site here but the site stuff in m2 is
fully functional (http://maven.apache.org/maven2) and it uses velocity
for the page layout, but the actual documentation can be written in
APT,
xdoc, docbook, and the simple FAQ markup that makes writing FAQs
pretty
easy. It's super fast, has been designed for i18n and the
documentation
supports macros the first of which is the snippet macro ripped off
from
confluence. With that you can reference whole/snippets of code from a
document at an arbitrary URL.
The maven site for m2 is here if you want to see the structure:
http://svn.apache.org/viewcvs.cgi/maven/components/trunk/maven-site/
With this you get the speed you want and you can keep all your
existing
documentation. It will integrate with m2 which will specifically deal
with aggregation of doco from modules. But right now it's fully
functional, and fast.
Just figured I'd let you know. Using velocity for the layout allows a
lot of flexibility as we expect people will write templates for
various
language support. And I'm obviously a fan of Velocity :-)
-David
On Tue, Jun 07, 2005 at 01:57:53PM -0400, Geir Magnusson Jr. wrote:
Ok - I pushed it out. When the servers synch, it will be there.
We need a more complete list of dependencies - and the intention
isn't our dep list, but rather the "collaboration" list. We have a
dep on clogging, for example, but I wouldn't consider that a
collaboration.
Also, I'll summarize the roadmap discussion and put that to the dev
list and then to the site...
geir
On Jun 7, 2005, at 1:30 PM, David Blevins wrote:
On Tue, Jun 07, 2005 at 05:59:26AM -0400, Geir Magnusson Jr. wrote:
On Jun 7, 2005, at 3:49 AM, David Blevins wrote:
On Mon, Jun 06, 2005 at 09:19:08PM -0400, Geir Magnusson Jr.
wrote:
The upside is that it takes <10 seconds to fully generate, so
adding content is a breeze.
That right there is enough for me. A definite step in the right
direction.
Lets decide if we want to go forward with this, even as a
temporary
measure. Maybe people will bite and want to contribute to it - at
the worst, we get the site updated quickly and get the
ApacheCon EU
ad on it...
+1 From me for the same reasons you state. We can get fancy as
time allows. Baby steps.
Thanks,
David
--
Geir Magnusson Jr +1-203-665-6437
[EMAIL PROTECTED]
--
jvz.
Jason van Zyl
jason at maven.org
http://maven.apache.org
the course of true love never did run smooth ...
-- Shakespeare
--
Geir Magnusson Jr +1-203-665-6437
[EMAIL PROTECTED]
