You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Niels van Kampenhout <n....@hippo.nl> on 2006/07/05 08:31:33 UTC
Incorrect link in forms documentation
Hi,
I just noticed that there is an incorrect link in the Cocoon Forms
documentation. In [1], at the end of the section "Selection lists",
there is a link which should lead to more info on selection lists [2],
but instead leads to the page about datatypes [3]. Very confusing. Can
someone fix this?
Thanks,
Niels
[1] http://cocoon.apache.org/2.1/userdocs/widgets/widget_field.html
[2] http://cocoon.apache.org/2.1/userdocs/widgetconcepts/selectionlists.html
[3] http://cocoon.apache.org/2.1/userdocs/widgetconcepts/datatypes.html
howto update the Cocoon website
Posted by David Crossley <cr...@apache.org>.
I had a brainwave recently. Any Cocoon committer is able
to now easily update the cocoon.apache.org website and
you do not need Forrest installed locally.
When the forrestbot at our zone [1] finishes the
Cocoon docs, it then tar-gzips them and makes them
available for download. Copy them into your SVN
working copy at
https://svn.apache.org/repos/asf/cocoon/site/site/2.1
and svn commit.
It is cumbersome because you get all docs, even though
only a few have changed. It is worth it because this
gets the important 2.1/changes.html out there. Note that
Forrest is now portraying the contributors much more
prominently.
I modified the instructions at:
http://wiki.apache.org/cocoon/CocoonWebsiteUpdate
[1] http://forrest.zones.apache.org/
-David
Ross Gardler wrote:
> Niels van Kampenhout wrote:
> >Ross Gardler wrote:
> >
> >>Niels van Kampenhout wrote:
> >>
> >>>Hmm. I understand from Arje that the documentation I refered to in my
> >>>post is outdated and not updated anymore. The latest documentation
> >>>apparently is at cocoon.zones.apache.org. To be honest, I was under
> >>>the impression that the docs @ cocoon.apache.org are the latest from
> >>>Daisy...
> >>
> >>This is incorrect. The published docs are the ones from Daisy. There
> >>is a time lag between them being edited and them being published. How
> >>long that lag is depends on when someone is able to publish them.
> >>
> >>The docs from Daisy are built once a day by the Forrestbot, see [1].
> >>These are not intended to be read by users, but are there so that devs
> >>can verify the latest version of the docs before they are published to
> >>the site.
> >>
> >>As for a link to the latest devlopment version of a doc in daisy, take
> >>a look at the bottom of any page in the docs collection where you will
> >>see the following text and link:
> >>
> >>"Errors and Improvements? If you see any errors or potential
> >>improvements in this document please help us: View, Edit or comment
> >>on the latest development version (registration required)."
> >
> >Oops, sorry, I was misinformed and didn't bother to check myself :-(
> >
> >Thanks for the clarification! Still I find it a bit confusing that there
> > three publicly available URLs with potentially three different versions
> >of the Cocoon documentation.
>
> How is it different from maintaing docs sources in SVN? In this case we
> would have a location for the sources (SVN), a location for the staging
> docs (local directory or a staging server) and a location for the public
> docs (web).
>
> The way I see it is:
>
> Dev docs in daisy are equivalent to svn sources (i.e for the devs)
>
> Forrest zone (or locally created docs) are equivalent to locally created
> docs from svn sources. These are for QA
>
> Published site is no different and is fo rthe end user.
>
> Ross
Re: Incorrect link in forms documentation
Posted by Ross Gardler <rg...@apache.org>.
Niels van Kampenhout wrote:
> Ross Gardler wrote:
>
>> Niels van Kampenhout wrote:
>>
>>> Hmm. I understand from Arje that the documentation I refered to in my
>>> post is outdated and not updated anymore. The latest documentation
>>> apparently is at cocoon.zones.apache.org. To be honest, I was under
>>> the impression that the docs @ cocoon.apache.org are the latest from
>>> Daisy...
>>
>>
>> This is incorrect. The published docs are the ones from Daisy. There
>> is a time lag between them being edited and them being published. How
>> long that lag is depends on when someone is able to publish them.
>>
>> The docs from Daisy are built once a day by the Forrestbot, see [1].
>> These are not intended to be read by users, but are there so that devs
>> can verify the latest version of the docs before they are published to
>> the site.
>>
>> As for a link to the latest devlopment version of a doc in daisy, take
>> a look at the bottom of any page in the docs collection where you will
>> see the following text and link:
>>
>> "Errors and Improvements? If you see any errors or potential
>> improvements in this document please help us: View, Edit or comment
>> on the latest development version (registration required)."
>
>
>
> Oops, sorry, I was misinformed and didn't bother to check myself :-(
>
> Thanks for the clarification! Still I find it a bit confusing that there
> three publicly available URLs with potentially three different versions
> of the Cocoon documentation.
How is it different from maintaing docs sources in SVN? In this case we
would have a location for the sources (SVN), a location for the staging
docs (local directory or a staging server) and a location for the public
docs (web).
The way I see it is:
Dev docs in daisy are equivalent to svn sources (i.e for the devs)
Forrest zone (or locally created docs) are equivalent to locally created
docs from svn sources. These are for QA
Published site is no different and is fo rthe end user.
Ross
Re: Incorrect link in forms documentation
Posted by Niels van Kampenhout <n....@hippo.nl>.
Ross Gardler wrote:
> Niels van Kampenhout wrote:
>> Hmm. I understand from Arje that the documentation I refered to in my
>> post is outdated and not updated anymore. The latest documentation
>> apparently is at cocoon.zones.apache.org. To be honest, I was under
>> the impression that the docs @ cocoon.apache.org are the latest from
>> Daisy...
>
> This is incorrect. The published docs are the ones from Daisy. There is
> a time lag between them being edited and them being published. How long
> that lag is depends on when someone is able to publish them.
>
> The docs from Daisy are built once a day by the Forrestbot, see [1].
> These are not intended to be read by users, but are there so that devs
> can verify the latest version of the docs before they are published to
> the site.
>
> As for a link to the latest devlopment version of a doc in daisy, take a
> look at the bottom of any page in the docs collection where you will see
> the following text and link:
>
> "Errors and Improvements? If you see any errors or potential
> improvements in this document please help us: View, Edit or comment on
> the latest development version (registration required)."
Oops, sorry, I was misinformed and didn't bother to check myself :-(
Thanks for the clarification! Still I find it a bit confusing that there
three publicly available URLs with potentially three different
versions of the Cocoon documentation.
Niels
Re: Incorrect link in forms documentation
Posted by Ross Gardler <rg...@apache.org>.
Niels van Kampenhout wrote:
> Reinhard Poetz wrote:
>
>> Niels van Kampenhout wrote:
>>
>>> Hi,
>>>
>>> I just noticed that there is an incorrect link in the Cocoon Forms
>>> documentation. In [1], at the end of the section "Selection lists",
>>> there is a link which should lead to more info on selection lists
>>> [2], but instead leads to the page about datatypes [3]. Very
>>> confusing. Can someone fix this?
>>>
>>> Thanks,
>>> Niels
>>>
>>> [1] http://cocoon.apache.org/2.1/userdocs/widgets/widget_field.html
>>> [2]
>>> http://cocoon.apache.org/2.1/userdocs/widgetconcepts/selectionlists.html
>>> [3] http://cocoon.apache.org/2.1/userdocs/widgetconcepts/datatypes.html
>>
>>
>> thanks for spotting this. Fixed in Daisy now.
>>
>
> Hmm. I understand from Arje that the documentation I refered to in my
> post is outdated and not updated anymore. The latest documentation
> apparently is at cocoon.zones.apache.org. To be honest, I was under the
> impression that the docs @ cocoon.apache.org are the latest from Daisy...
>
> Isn't it ridiculous that if I click on 'documentation' at
> cocoon.apache.org, I am presented outdated docs, and no link whatsoever
> to the new ones? Not very user friendly, anyway.
This is incorrect. The published docs are the ones from Daisy. There is
a time lag between them being edited and them being published. How long
that lag is depends on when someone is able to publish them.
The docs from Daisy are built once a day by the Forrestbot, see [1].
These are not intended to be read by users, but are there so that devs
can verify the latest version of the docs before they are published to
the site.
As for a link to the latest devlopment version of a doc in daisy, take a
look at the bottom of any page in the docs collection where you will see
the following text and link:
"Errors and Improvements? If you see any errors or potential
improvements in this document please help us: View, Edit or comment on
the latest development version (registration required)."
Ross
[1] http://forrest.zones.apache.org/ft/build/cocoon-docs/2.1/index.html
Re: Incorrect link in forms documentation
Posted by Niels van Kampenhout <n....@hippo.nl>.
Reinhard Poetz wrote:
> Niels van Kampenhout wrote:
>> Hi,
>>
>> I just noticed that there is an incorrect link in the Cocoon Forms
>> documentation. In [1], at the end of the section "Selection lists",
>> there is a link which should lead to more info on selection lists [2],
>> but instead leads to the page about datatypes [3]. Very confusing. Can
>> someone fix this?
>>
>> Thanks,
>> Niels
>>
>> [1] http://cocoon.apache.org/2.1/userdocs/widgets/widget_field.html
>> [2]
>> http://cocoon.apache.org/2.1/userdocs/widgetconcepts/selectionlists.html
>> [3] http://cocoon.apache.org/2.1/userdocs/widgetconcepts/datatypes.html
>
> thanks for spotting this. Fixed in Daisy now.
>
Hmm. I understand from Arje that the documentation I refered to in my
post is outdated and not updated anymore. The latest documentation
apparently is at cocoon.zones.apache.org. To be honest, I was under the
impression that the docs @ cocoon.apache.org are the latest from Daisy...
Isn't it ridiculous that if I click on 'documentation' at
cocoon.apache.org, I am presented outdated docs, and no link whatsoever
to the new ones? Not very user friendly, anyway.
Just my 2 cents...
Regards,
Niels
Re: Incorrect link in forms documentation
Posted by Reinhard Poetz <re...@apache.org>.
Niels van Kampenhout wrote:
> Hi,
>
> I just noticed that there is an incorrect link in the Cocoon Forms
> documentation. In [1], at the end of the section "Selection lists",
> there is a link which should lead to more info on selection lists [2],
> but instead leads to the page about datatypes [3]. Very confusing. Can
> someone fix this?
>
> Thanks,
> Niels
>
> [1] http://cocoon.apache.org/2.1/userdocs/widgets/widget_field.html
> [2]
> http://cocoon.apache.org/2.1/userdocs/widgetconcepts/selectionlists.html
> [3] http://cocoon.apache.org/2.1/userdocs/widgetconcepts/datatypes.html
thanks for spotting this. Fixed in Daisy now.
--
Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc
--------------------------------------------------------------------
___________________________________________________________
Telefonate ohne weitere Kosten vom PC zum PC: http://messenger.yahoo.de