You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Lars Huttar <la...@sil.org> on 2007/10/02 17:50:47 UTC

Re: Cocoon 2.2 documentation online!

On 9/28/2007 10:41 AM, Reinhard Poetz wrote:
> Vadim Gritsenko wrote:
>> Reinhard Poetz wrote:
>>>
>>> While I was creating all the release artifacts of Cocoon 2.2RC2 I 
>>> also published our 2.2 docs. See http://cocoon.apache.org/2.2/
>>>
>>> I have to say that I'm really proud of seeing this long-term effort 
>>> finally materializing :-) Thanks to all the involved helping hands!
>>>
>>> The only missing part is the main site (http://cocoon.apache.org). 
>>> If nobody speaks up over the weekend, I will also publish it (see 
>>> http://cocoon.zones.apache.org/dev-docs/) on Monday. It would be 
>>> great if a native speaker could proof-read it in the meantime.
This response may be too late for that request, but in general, I would 
be happy to proofread any Cocoon documentation. (I am a native English 
speaker... if Americans are allowed. :-)

I could probably proofread a few pages a day, *if* there is a simple way 
to submit the results (e.g. without having to set up Maven).

Lars
>>
>> I noticed that component's basic information table is incorrect. For 
>> example
>>   http://cocoon.apache.org/2.2/core-modules/core/2.2/889_1_1.html
>>
>> Should read:
>>   Component type    Action
>>   Cocoon block    core
>>   Java class    org.apache.cocoon.acting.LocaleAction
>>   Cachable
>>
>> This is probably error in the template? Also, "Cachable" should be 
>> "Cacheable". Where would I fix it?
>
> see 
> https://svn.apache.org/repos/asf/cocoon/trunk/tools/cocoon-daisy-export-strategy/src/main/resources/org/apache/cocoon/tools/maven/daisy/export/strategy/cocoon-doc-2-xdoc.xslt 
>
>
> This stylesheet transforms the documents which are read from the Daisy 
> repository into something the Maven 2 site plugin can deal with.
>
> If you want to test it, change the stylesheet, then install the Daisy 
> export plugin into your local Maven repository by running 'mvn 
> install', go into a module that contains sitemap components and run 
> 'mvn site -P daisy'
>
> But before make sure that you've configured Maven as explained in 
> http://cocoon.zones.apache.org/daisy/cdocs/g3/1256.html so that you 
> can access the Daisy repository. (@vadim: it should  work with your 
> Daisy user because it already  has administration rights granted.)
>
>                                   - o -
>
> http://cocoon.zones.apache.org/daisy/cdocs/g3/1256.html also explains 
> how you can create (and/or deploy) all docs at one go.
>
>                                   - o -
>
> One note: As soon as I have some time I will write a Maven 2 plugin 
> which removes all non-Daisy docs from ./target/site before they are 
> deployed. Otherwise we would overwrite all reports with reports that 
> refer to a snapshot versions.
>


Re: Cocoon 2.2 documentation online!

Posted by Reinhard Poetz <re...@apache.org>.
Lars Huttar wrote:
> On 9/28/2007 10:41 AM, Reinhard Poetz wrote:
>> Vadim Gritsenko wrote:
>>> Reinhard Poetz wrote:
>>>>
>>>> While I was creating all the release artifacts of Cocoon 2.2RC2 I 
>>>> also published our 2.2 docs. See http://cocoon.apache.org/2.2/
>>>>
>>>> I have to say that I'm really proud of seeing this long-term effort 
>>>> finally materializing :-) Thanks to all the involved helping hands!
>>>>
>>>> The only missing part is the main site (http://cocoon.apache.org). 
>>>> If nobody speaks up over the weekend, I will also publish it (see 
>>>> http://cocoon.zones.apache.org/dev-docs/) on Monday. It would be 
>>>> great if a native speaker could proof-read it in the meantime.
> This response may be too late for that request, but in general, I would 
> be happy to proofread any Cocoon documentation. (I am a native English 
> speaker... if Americans are allowed. :-)

America, America, hmmm, I heard once about it ... ;-)

> 
> I could probably proofread a few pages a day, *if* there is a simple way 
> to submit the results (e.g. without having to set up Maven).

Thanks for your offer. Just follow the "edit" link on the bottom of a page. It 
links to the source page in our CMS (Daisy). In order to login, self-register at 
Daisy and send me a mail with your username in private so that I can activate 
your account.

-- 
Reinhard Pötz                            Managing Director, {Indoqa} GmbH
                           http://www.indoqa.com/en/people/reinhard.poetz/

Member of the Apache Software Foundation
Apache Cocoon Committer, PMC member, PMC Chair        reinhard@apache.org
_________________________________________________________________________