You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@directory.apache.org by Vincent Tence <vt...@pyxis-tech.com> on 2004/07/02 04:39:27 UTC

Re: [sitedocs] Reworking the docs

I've been trying to build the website using the multiproject goal for 
the last 2 hours without success. I'm giving up.

I have some questions regarding the multiproject plugin:

1. Should we still be using a sitedocs subproject or should we move the 
xdocs to the top-level directory project?

2. Do we still need the sitedocs/trunk/xdocs/subprojects dir?

3. What happens when subprojects in turn contains subprojects with xdocs 
(I know eve does)?

4. I understood we should get rid of our .jsl template and custom site 
post goals. Is that correct?

5. Is there any requirement in the subprojects project.xml file for the 
multiproject:site goal to work?

Thanks,
Vincent

Alex Karasulu wrote:

>On Mon, 2004-06-28 at 23:58, Brett Porter wrote:
>  
>
>>The collectdocs stuff could probably be replaced with multiproject:site out of
>>the box...
>>    
>>
>
>Good looking out Brett.  Then that's the approach we should take.  Scrap
>the hokey stuff we got and follow up using multiproject.  Actually I've
>very fond of multiproject.
>
>BTW do you guys know that we all have free IntelliJ IDEA licenses?  The
>idea:multiproject works really nicely in setting up idea for projects
>like Eve that have a gazzillion different projects.
>
>Also at some point I had looked at what the Geronimo folks have done
>with their builds and its looking really nice.  We might want to look at
>what they have before we proceed.
>
>Alex
>
>
>
>  
>


Re: [sitedocs] Reworking the docs

Posted by Alex Karasulu <ao...@bellsouth.net>.
On Thu, 2004-07-01 at 22:39, Vincent Tence wrote:
> I've been trying to build the website using the multiproject goal for 
> the last 2 hours without success. I'm giving up.

Sorry this is probably my fault :(.

> I have some questions regarding the multiproject plugin:
> 
> 1. Should we still be using a sitedocs subproject or should we move the 
> xdocs to the top-level directory project?

Don't know would that be easier for ya.  Look if you're going to wrestle
with things go ahead and chop it away - do what you think is best.  We
understand some things may break in the process and they can be
addressed so if you want to scrap my crap go ahead and restructure as
you please.  Trust me this may not be the best way to go.

> 2. Do we still need the sitedocs/trunk/xdocs/subprojects dir?

Probably not - I want to get rid of this subprojects layer.  Let's go
ahead and restructure.

> 3. What happens when subprojects in turn contains subprojects with xdocs 
> (I know eve does)?

Yeah I see where you're going its a damn nightmare.  Tell me what you
want to do?

> 4. I understood we should get rid of our .jsl template and custom site 
> post goals. Is that correct?

Yes.  We want the maven functionality out of the box to keep things
simple.

> 5. Is there any requirement in the subprojects project.xml file for the 
> multiproject:site goal to work?

Don't know have never used the multiproject:site goal.  I was intending
to get involved.  Right now I'm doing the eve consolidation.  I will
cleanup the docs with you but tell me where you want to go with site
document generation?  Let's cordinate but you take the reigns on this
one - let me know how you want me to grok it.

> >On Mon, 2004-06-28 at 23:58, Brett Porter wrote:
> >  
> >
> >>The collectdocs stuff could probably be replaced with multiproject:site out of
> >>the box...
> >>    
> >>
> >
> >Good looking out Brett.  Then that's the approach we should take.  Scrap
> >the hokey stuff we got and follow up using multiproject.  Actually I've
> >very fond of multiproject.
> >
> >BTW do you guys know that we all have free IntelliJ IDEA licenses?  The
> >idea:multiproject works really nicely in setting up idea for projects
> >like Eve that have a gazzillion different projects.
> >
> >Also at some point I had looked at what the Geronimo folks have done
> >with their builds and its looking really nice.  We might want to look at
> >what they have before we proceed.
> >
> >Alex
> >
> >
> >
> >  
> >
> 


Re: [sitedocs] Reworking the docs

Posted by Vincent Tence <vt...@pyxis-tech.com>.
Vincent Tence wrote:

> I've been trying to build the website using the multiproject goal for 
> the last 2 hours without success. I'm giving up.

Sorry about that. I was getting depressed :-).

The generation fails at the end when trying to copy subprojects web 
sites to aggregate site. It tries to create a directory named 
directory:null.

For example when generating the docs from the sitedocs/trunk dir with 
the following properties:
maven.multiproject.basedir = ${basedir}/../..
maven.multiproject.includes = janus/trunk/project.xml

I commented out the custom site postGoals in janus maven.xml and the 
maven.xdocs.xxx properties. I also removed the 
sitedocs/trunk/xdocs/subprojects/janus/* files so that the generated 
suproject web site is included instead. I am unsure about what to do 
with the sitedocs/trunk/xdocs/subprojects/ dir when using the 
multiproject:site goal. Is it still required or is it getting in the way?

>
> I have some questions regarding the multiproject plugin:
>
> 1. Should we still be using a sitedocs subproject or should we move 
> the xdocs to the top-level directory project?
>
> 2. Do we still need the sitedocs/trunk/xdocs/subprojects dir?
>
> 3. What happens when subprojects in turn contains subprojects with 
> xdocs (I know eve does)?
>
> 4. I understood we should get rid of our .jsl template and custom site 
> post goals. Is that correct?
>
> 5. Is there any requirement in the subprojects project.xml file for 
> the multiproject:site goal to work?
>
> Thanks,
> Vincent
>
> Alex Karasulu wrote:
>
>> On Mon, 2004-06-28 at 23:58, Brett Porter wrote:
>>  
>>
>>> The collectdocs stuff could probably be replaced with 
>>> multiproject:site out of
>>> the box...
>>>   
>>
>>
>> Good looking out Brett.  Then that's the approach we should take.  Scrap
>> the hokey stuff we got and follow up using multiproject.  Actually I've
>> very fond of multiproject.
>>
>> BTW do you guys know that we all have free IntelliJ IDEA licenses?  The
>> idea:multiproject works really nicely in setting up idea for projects
>> like Eve that have a gazzillion different projects.
>>
>> Also at some point I had looked at what the Geronimo folks have done
>> with their builds and its looking really nice.  We might want to look at
>> what they have before we proceed.
>>
>> Alex
>>
>>
>>
>>  
>>
>
>
>