geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Geir Magnusson Jr." <ge...@apache.org>
Subject Re: proposal for new site
Date Thu, 09 Jun 2005 04:04:58 GMT
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
>>> geirm@apache.org
>>>
>>>
>>
>>
> -- 
> 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
geirm@apache.org



Mime
View raw message