Re: Cocoon 2.2 documentation online!
Lars Huttar wrote: On 9/28/2007 9:26 AM, 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. One thing I see is that the page titles (i.e. the html/head/title element) is not set specifically. For example, on http://cocoon.apache.org/2.2/1366_1_1.html the title shown in the h1 element in the body is "How to configure consistent encoding in Cocoon", but the title in /html/head/title is "Cocoon 2.2". If all the doc pages have the title "Cocoon 2.2", that doesn't work well if you're bookmarking various doc pages. I tried editing the page, but the only title I could find there was "How to configure consistent encoding in Cocoon", under "Document name". So I suspect the fix for this issue is not in the individual documents, but in the process for producing pages. Thanks for reporting. I will have a look into this. -- Reinhard PötzManaging Director, {Indoqa} GmbH http://www.indoqa.com/en/people/reinhard.poetz/ Member of the Apache Software Foundation Apache Cocoon Committer, PMC member, PMC Chair[EMAIL PROTECTED] _
Re: Cocoon 2.2 documentation online!
On 9/28/2007 9:26 AM, 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. One thing I see is that the page titles (i.e. the html/head/title element) is not set specifically. For example, on http://cocoon.apache.org/2.2/1366_1_1.html the title shown in the h1 element in the body is "How to configure consistent encoding in Cocoon", but the title in /html/head/title is "Cocoon 2.2". If all the doc pages have the title "Cocoon 2.2", that doesn't work well if you're bookmarking various doc pages. I tried editing the page, but the only title I could find there was "How to configure consistent encoding in Cocoon", under "Document name". So I suspect the fix for this issue is not in the individual documents, but in the process for producing pages. Lars
Re: Cocoon 2.2 documentation online!
hepabolu wrote: On all of them. I just tested the main page, the one with the picture of the graphic of the architecture (Spring framework) and some others I can't remember. I added the missing .htaccess file (though I still find it strange that it worked for me yesterday ...) Thanks for reporting! -- Reinhard PötzManaging Director, {Indoqa} GmbH http://www.indoqa.com/en/people/reinhard.poetz/ Member of the Apache Software Foundation Apache Cocoon Committer, PMC member, PMC Chair[EMAIL PROTECTED] _
Re: Cocoon 2.2 documentation online!
Reinhard Poetz said the following on 2/10/07 18:08: hepabolu wrote: Reinhard Poetz said the following on 28/9/07 16:26: 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! Excellent work! I just noticed that the 'subprojects' link on the right leads to the directory, rather than the index.html file. hmm, on which page do you notice this behaviour? For me it works ... On all of them. I just tested the main page, the one with the picture of the graphic of the architecture (Spring framework) and some others I can't remember. Bye, Helma
Re: Cocoon 2.2 documentation online!
hepabolu wrote: Reinhard Poetz said the following on 28/9/07 16:26: 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! Excellent work! I just noticed that the 'subprojects' link on the right leads to the directory, rather than the index.html file. hmm, on which page do you notice this behaviour? For me it works ... Bye, Helma PS. Sorry, won't be at the CocoonGT That's a pity :-( > Have fun all of you. Thanks! -- Reinhard PötzManaging Director, {Indoqa} GmbH http://www.indoqa.com/en/people/reinhard.poetz/ Member of the Apache Software Foundation Apache Cocoon Committer, PMC member, PMC Chair[EMAIL PROTECTED] _
Re: Cocoon 2.2 documentation online!
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ötzManaging Director, {Indoqa} GmbH http://www.indoqa.com/en/people/reinhard.poetz/ Member of the Apache Software Foundation Apache Cocoon Committer, PMC member, PMC Chair[EMAIL PROTECTED] _
Re: Cocoon 2.2 documentation online!
Reinhard Poetz said the following on 28/9/07 16:26: 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! Excellent work! I just noticed that the 'subprojects' link on the right leads to the directory, rather than the index.html file. Bye, Helma PS. Sorry, won't be at the CocoonGT. Have fun all of you.
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 typeAction Cocoon blockcore Java classorg.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!
Vadim Gritsenko wrote: Reinhard Poetz wrote: If you want to test it, change the stylesheet, then install the Daisy export plugin into your local Maven repository by running 'mvn install', Hmm this step failed with [INFO] [ERROR] BUILD ERROR [INFO] [INFO] Failed to resolve artifact. Missing: -- 1) org.daisycms:daisy-maven-plugin:jar:1.0.0-alpha-1 the daisy-maven-plugin isn't available at the central Maven repository. Please try again with mvn install -P daisy (the 'daisy' profile contains a reference to the cocoondev.org Maven 2 repository) -- Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach {Software Engineering, Open Source, Web Applications, Apache Cocoon} web(log): http://www.poetz.cc
Re: Cocoon 2.2 documentation online!
Reinhard Poetz wrote: If you want to test it, change the stylesheet, then install the Daisy export plugin into your local Maven repository by running 'mvn install', Hmm this step failed with [INFO] [ERROR] BUILD ERROR [INFO] [INFO] Failed to resolve artifact. Missing: -- 1) org.daisycms:daisy-maven-plugin:jar:1.0.0-alpha-1 Vadim go into a module that contains sitemap components and run 'mvn site -P daisy'
Re: Cocoon 2.2 documentation online!
Reinhard Poetz schrieb: > > 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. > It's great to see the new site online :-) ! Just a small note: I noticed a simular problem on both sites (c.z.a.o/dev-docs/ and c.a.o/2.2/) under Linux/Firefox and Windows/MSIE: When you click into the search field ontop right corner the text is still there. It would be nice if we could clean the field when clicking into ()Remove the hint text from the box) as it is on the 'old' page http://cocoon.apache.org/2.1/. Regards Felix
Re: Cocoon 2.2 documentation online!
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. 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 typeAction Cocoon blockcore Java classorg.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. -- Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach {Software Engineering, Open Source, Web Applications, Apache Cocoon} web(log): http://www.poetz.cc
Re: Cocoon 2.2 documentation online!
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. 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 typeAction Cocoon block core Java classorg.apache.cocoon.acting.LocaleAction Cachable This is probably error in the template? Also, "Cachable" should be "Cacheable". Where would I fix it? Vadim
Cocoon 2.2 documentation online!
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. -- Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach {Software Engineering, Open Source, Web Applications, Apache Cocoon} web(log): http://www.poetz.cc