cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Reinhard Poetz <>
Subject Re: [docs] "docs" Ant target
Date Fri, 11 Mar 2005 08:20:18 GMT
David Crossley wrote:
> Reinhard Poetz wrote:
>>David Crossley wrote:
> [snip]
>>>Perhaps we should step back a bit and assess the situation. It seems
>>>a cumbersome process to double-handle all of the source docs, just to
>>>add some specially-generated docs. Would it help to put these special
>>>docs into a completely separate workspace?
>>I don't like this duplicaton process either. Well, as far as I understand, 
>>the reasons for this is that we want to style the docs using the common 
>>skin and not something different.
> The copying of the source docs over to the build space was just so the
> additional docs could get generated into that space too. They could instead
> get generated into trunk/src/documentation/xdocs/sitemap-docs/
> and we tell forrest to ignore the original sources at
> trunk/src/documentation/xdocs/userdocs/
> I like your suggestion below. The "content" is what is important.
> Each descriptive doc about sitemap components at /userdocs/ could just link
> to the relevant generated doc at /2.2/sitemap-components/*.html rather than
> trying to merge them (which is what is making it complicated).

Upayavira doesn't really like this solution. We worked out another one - see my 
mail "Automatically generated docs". WDYT?

>>The question is, do we really need the 
>>sitemap-component docs (some kind of API documentation) in this common 
>>style? I'd say no. They are similar to javadocs and nobody has ever 
>>complained about not having the tightly integrated in our website. (I don't 
>>want to say that I wouldn't like seeing all docs in the common style but 
>>it's not worth doing the huge amount of work to get it done.)
>>Maybe  we can agree on this: Generated documentation is linked from our 
>>documenation but is not integrated in our common style:
>>This would make thinks much easier. WDOT?
> It probably would.
> --David

Reinhard Pötz           Independant Consultant, Trainer & (IT)-Coach 

{Software Engineering, Open Source, Web Applications, Apache Cocoon}


View raw message