incubator-wadi-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Genender <jgenen...@apache.org>
Subject Re: web site resources?
Date Fri, 23 Dec 2005 18:45:32 GMT
I believe checking in a maven gened site is like checking in a binary.
Its also duplicate work and may cause confusion.  I don't see why this
is an issue.  All it takes is a "mvn site"...and its there for the
viewing.  Am I not seeing something important?

Jeff

Geir Magnusson Jr. wrote:
> Why would every file change?
> 
> If every file changes on each re-gen, you need to change your system,
> IMO.  It should be predictable and/or controlable.
> 
> geir
> 
> On Dec 23, 2005, at 12:36 PM, James Goodwill wrote:
> 
>> I am not a big fan of checking the site in, especially when it is a
>> situation that every file in the repo will change on a new gen. I
>> don't know if we would gain anything.
>>
>>
>>
>>
>> On Dec 23, 2005, at 10:31 AM, Jeff Genender wrote:
>>
>>> I don't like the generated stuff going into SVN.  Its terribly easy to
>>> gen a site.
>>>
>>> Bill Dudney wrote:
>>>> On Dec 23, 2005, at 9:42 AM, Geir Magnusson Jr wrote:
>>>>
>>>>>
>>>>> On Dec 23, 2005, at 9:42 AM, Bill Dudney wrote:
>>>>>
>>>>>> Thanks Geir,
>>>>>>
>>>>>> On Dec 23, 2005, at 7:16 AM, Geir Magnusson Jr. wrote:
>>>>>>
>>>>>>> yes, and you aren't going to like it :)
>>>>>>>
>>>>>>
>>>>>> Your kidding right? I love pain :-)
>>>>>>
>>>>>>> What does the maven2 generated site look like now?
>>>>>>>
>>>>>>
>>>>>> A broken version is currently on codehaus (wadi.codehaus.org).
>>>>>>
>>>>>>> I was just reading this list to propose an alternative, as simple
>>>>>>> xdoc oriented site that I've used successfully in geronimo, harmony,
>>>>>>> jdo and agila lately.  Very simple.
>>>>>>>
>>>>>>
>>>>>> The agila site looks fine. But we have burned a lot of cycles on
>>>>>> getting javadoc, clover, jxr, etc etc etc integrated into our maven
>>>>>> build. I'd hate for all that to go to waste.
>>>>>>
>>>>>
>>>>> Fair enough.  So how does one add to and regen the maven2 site?
>>>>
>>>> 'mvn site' will regen the site 'mvn site:deploy' will push a new copy.
>>>>
>>>>>
>>>>>>> But if there's already a pile of maven generated cruft, why not.
>>>>>>>
>>>>>>
>>>>>> Agreed the output of maven is crufty, what alternative is there to
>>>>>> getting a whole site generated, with clover, javadoc etc?
>>>>>
>>>>> I can't find the clover stuff on the website.  are people clamoring to
>>>>> have it there, or is it more useful for people when working lcoally?
>>>>>
>>>>> As for javadoc, I think that's a horrorshow to put in svn.  the WS
>>>>> project recently did that, resulting in hosing the poor ASf mail
>>>>> system as it tried to cope with what was effectively a 7G mailbomb as
>>>>> generated by the svn diffs into email
>>>>>
>>>>
>>>> clover is not deployed yet but its at least as big as javadoc so I
>>>> don't
>>>> want it in SVN. Good point thought that its probably better left as a
>>>> local only report.
>>>>
>>>> What does everyone else think?
>>>>
>>>>>>
>>>>>>> And yes, it's good to just check in the artifacts and do a svn
co on
>>>>>>> the webserver.
>>>>>>>
>>>>>>
>>>>>> Check in the maven generated cruft? or the source xdoc documents
and
>>>>>> generate then publish?
>>>>>>
>>>>>
>>>>> check in all generated crap you want on the site.  That makes it easy
>>>>> for someone to check it out and look at it locally w/o having to
>>>>> figure out how to generate it.  At least for docs and such, this is
>>>>> helpful.
>>>>>
>>>>> my 0.02
>>>>
>>>> perhaps I'm misunderstanding - my initial question was 'do we have to
>>>> have our site in SVN'. Should I infer from this that we do have to put
>>>> our generated stuff into SVN?
>>>>
>>>> Thanks again,
>>>>
>>>>>>
>>>>>>
>>>>>> Bill Dudney
>>>>>> MyFaces - myfaces.apache.org
>>>>>> Wadi - incubator.apache.org/wadi
>>>>>>
>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> On Dec 23, 2005, at 8:12 AM, Bill Dudney wrote:
>>>>>>>
>>>>>>>> Hi Geir,
>>>>>>>>
>>>>>>>> Any input on this question?
>>>>>>>>
>>>>>>>> Thanks,
>>>>>>>>
>>>>>>>> Bill Dudney
>>>>>>>> MyFaces - myfaces.apache.org
>>>>>>>> Wadi - incubator.apache.org/wadi
>>>>>>>>
>>>>>>>> Begin forwarded message:
>>>>>>>>
>>>>>>>>> From: Bill Dudney <bdudney@apache.org>
>>>>>>>>> Date: December 21, 2005 1:34:06 PM MST
>>>>>>>>> To: general@incubator.apache.org
>>>>>>>>> Cc: wadi-dev@incubator.apache.org
>>>>>>>>> Subject: web site resources?
>>>>>>>>> Reply-To: wadi-dev@incubator.apache.org
>>>>>>>>>
>>>>>>>>> Hi All,
>>>>>>>>>
>>>>>>>>> I'm working on getting the wadi website setup. I was
wondering how
>>>>>>>>> we should populate our site, here;
>>>>>>>>>
>>>>>>>>> http://incubator.apache.org/howtoparticipate.html#Project+Website+Howto
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> it says that our site should be built from svn stored
resources
>>>>>>>>> with a checkout (svn ... co) but out site is generated
by maven 2.
>>>>>>>>> I'm assuming that the idea is that we don't keep copies
of info on
>>>>>>>>> our site that will go stale. If that is the case this
is it OK to
>>>>>>>>> just publish our site from maven?
>>>>>>>>>
>>>>>>>>> Thanks for the help!
>>>>>>>>>
>>>>>>>>> TTFN,
>>>>>>>>>
>>>>>>>>> Bill Dudney
>>>>>>>>> MyFaces - myfaces.apache.org
>>>>>>>>> Wadi - incubator.apache.org/wadi
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>> --Geir Magnusson Jr                                  +1-203-665-6437
>>>>>>> geirm@apache.org
>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>> --Geir Magnusson Jr                                  +1-203-665-6437
>>>>> geir@optonline.net
>>>>>
>>>>>
>>>
>>
> 
> --Geir Magnusson Jr                                  +1-203-665-6437
> geirm@apache.org
> 

Mime
View raw message