You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Reinhard Poetz <re...@apache.org> on 2005/02/22 09:38:16 UTC
[Vote] Make doc-repos/2.2 & doc-repos/portal-block official documentation
repositories
Over the last weeks I've setup new documentation repositories in
whiteboard/doc-repos. I want to make two of them
cocoon/whiteboard/doc-repos/2.2 and
cocoon/whiteboard/doc-repos/portal-block
official documentation repositories. This means moving them to
cocoon/trunk/src/documentation and
cocoon/blocks/portal/trunk/src/documentation
(Note that for now the repository at cocoon/whiteboard/doc-repos/global remains
where it is, until it is filled with content and ready to replace the current
repository at cocoon/site/src.)
The new repositories can be build using Forrest 0.6 and the doctype of documents
is HTML (for now, until the online-editing scenario is in available). Each
document consist of a directory that contains the content (content_en.html),
meta data (meta.xml) and a subdirectory 'files' that can contain resources like
images.
Before replacing the documents in cocoon/trunk/src/documentation, Upayavira will
ensure that all docs that differ from the 2.1 docs will be saved.
Detailed explanations on how the new documentation system is supposed to work
can be found at http://wiki.apache.org/cocoon/CocoonDocumentationSystemSUMMARY
and at http://wiki.apache.org/cocoon/22NewDocuments.
Please cast your votes!
--
Reinhard Pötz Independant Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc
--------------------------------------------------------------------
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Daniel Fagerstrom <da...@nada.kth.se>.
Reinhard Poetz wrote:
> Over the last weeks I've setup new documentation repositories in
> whiteboard/doc-repos. I want to make two of them
>
> cocoon/whiteboard/doc-repos/2.2 and
> cocoon/whiteboard/doc-repos/portal-block
>
> official documentation repositories.
+1
/Daniel
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official documentation repositories
Posted by David Crossley <cr...@apache.org>.
Reinhard Poetz wrote:
> Bertrand Delacretaz wrote:
> >Reinhard Poetz a ?crit :
> >
> >>...Before replacing the documents in cocoon/trunk/src/documentation,
> >>Upayavira will ensure that all docs that differ from the 2.1 docs will
> >>be saved...
> >
> >Saved = moved to a directory where they can easily be found while this
> >evolves, I assume?
>
> yes (you're right, SVN would have saved it too but it would be difficult
> for people moving docs to access deleted docs)
That was my only concern too.
+0 ... meaning that i am not able to help much at the moment.
--David
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Reinhard Poetz <re...@apache.org>.
Bertrand Delacretaz wrote:
> Le 22 févr. 05, à 09:38, Reinhard Poetz a écrit :
>
>> ...Before replacing the documents in cocoon/trunk/src/documentation,
>> Upayavira will ensure that all docs that differ from the 2.1 docs will
>> be saved...
>
>
> Saved = moved to a directory where they can easily be found while this
> evolves, I assume?
yes (you're right, SVN would have saved it too but it would be difficult for
people moving docs to access deleted docs)
>> ...Please cast your votes!
>
>
> +1, cannot help ATM but please keep it up!
>
> -Bertrand
--
Reinhard Pötz Independant Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc
--------------------------------------------------------------------
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Upayavira <uv...@upaya.co.uk>.
Bertrand Delacretaz wrote:
> Le 22 févr. 05, à 09:38, Reinhard Poetz a écrit :
>
>> ...Before replacing the documents in cocoon/trunk/src/documentation,
>> Upayavira will ensure that all docs that differ from the 2.1 docs will
>> be saved...
>
>
> Saved = moved to a directory where they can easily be found while this
> evolves, I assume?
Exactly. Yes.
Upayavira
>> ...Please cast your votes!
>
>
> +1, cannot help ATM but please keep it up!
>
> -Bertrand
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official documentation repositories
Posted by Bertrand Delacretaz <bd...@apache.org>.
Le 22 févr. 05, à 09:38, Reinhard Poetz a écrit :
> ...Before replacing the documents in cocoon/trunk/src/documentation,
> Upayavira will ensure that all docs that differ from the 2.1 docs will
> be saved...
Saved = moved to a directory where they can easily be found while this
evolves, I assume?
> ...Please cast your votes!
+1, cannot help ATM but please keep it up!
-Bertrand
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Giacomo Pati <gi...@apache.org>.
Reinhard Poetz wrote:
> Over the last weeks I've setup new documentation repositories in
> whiteboard/doc-repos. I want to make two of them
>
> cocoon/whiteboard/doc-repos/2.2 and
> cocoon/whiteboard/doc-repos/portal-block
>
> official documentation repositories. This means moving them to
>
> cocoon/trunk/src/documentation and
> cocoon/blocks/portal/trunk/src/documentation
>
> (Note that for now the repository at cocoon/whiteboard/doc-repos/global
> remains where it is, until it is filled with content and ready to
> replace the current repository at cocoon/site/src.)
>
>
> The new repositories can be build using Forrest 0.6 and the doctype of
> documents is HTML (for now, until the online-editing scenario is in
> available). Each document consist of a directory that contains the
> content (content_en.html), meta data (meta.xml) and a subdirectory
> 'files' that can contain resources like images.
>
>
> Before replacing the documents in cocoon/trunk/src/documentation,
> Upayavira will ensure that all docs that differ from the 2.1 docs will
> be saved.
>
> Detailed explanations on how the new documentation system is supposed to
> work can be found at
> http://wiki.apache.org/cocoon/CocoonDocumentationSystemSUMMARY and at
> http://wiki.apache.org/cocoon/22NewDocuments.
>
> Please cast your votes!
>
+1
--
Giacomo Pati
Otego AG, Switzerland - http://www.otego.com
Orixo, the XML business alliance - http://www.orixo.com
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Torsten Curdt <tc...@apache.org>.
>> Please cast your votes!
>>
>
> +1 from me of course
Thanks for the effort guys! +1
cheers
--
Torsten
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Leszek Gawron <lg...@apache.org>.
Reinhard Poetz wrote:
> Reinhard Poetz wrote:
>
>> Over the last weeks I've setup new documentation repositories in
>> whiteboard/doc-repos. I want to make two of them
>>
>> cocoon/whiteboard/doc-repos/2.2 and
>> cocoon/whiteboard/doc-repos/portal-block
>>
>> official documentation repositories. This means moving them to
>>
>> cocoon/trunk/src/documentation and
>> cocoon/blocks/portal/trunk/src/documentation
>>
>> (Note that for now the repository at
>> cocoon/whiteboard/doc-repos/global remains where it is, until it is
>> filled with content and ready to replace the current repository at
>> cocoon/site/src.)
>>
>>
>> The new repositories can be build using Forrest 0.6 and the doctype of
>> documents is HTML (for now, until the online-editing scenario is in
>> available). Each document consist of a directory that contains the
>> content (content_en.html), meta data (meta.xml) and a subdirectory
>> 'files' that can contain resources like images.
>>
>>
>> Before replacing the documents in cocoon/trunk/src/documentation,
>> Upayavira will ensure that all docs that differ from the 2.1 docs will
>> be saved.
>>
>> Detailed explanations on how the new documentation system is supposed
>> to work can be found at
>> http://wiki.apache.org/cocoon/CocoonDocumentationSystemSUMMARY and at
>> http://wiki.apache.org/cocoon/22NewDocuments.
>>
>> Please cast your votes!
>>
>
> +1 from me of course
>
+1, the sooner the better
--
Leszek Gawron MobileBox
lgawron@apache.org http://www.mobilebox.pl
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Reinhard Poetz <re...@apache.org>.
Reinhard Poetz wrote:
> Over the last weeks I've setup new documentation repositories in
> whiteboard/doc-repos. I want to make two of them
>
> cocoon/whiteboard/doc-repos/2.2 and
> cocoon/whiteboard/doc-repos/portal-block
>
> official documentation repositories. This means moving them to
>
> cocoon/trunk/src/documentation and
> cocoon/blocks/portal/trunk/src/documentation
>
> (Note that for now the repository at cocoon/whiteboard/doc-repos/global
> remains where it is, until it is filled with content and ready to
> replace the current repository at cocoon/site/src.)
>
>
> The new repositories can be build using Forrest 0.6 and the doctype of
> documents is HTML (for now, until the online-editing scenario is in
> available). Each document consist of a directory that contains the
> content (content_en.html), meta data (meta.xml) and a subdirectory
> 'files' that can contain resources like images.
>
>
> Before replacing the documents in cocoon/trunk/src/documentation,
> Upayavira will ensure that all docs that differ from the 2.1 docs will
> be saved.
>
> Detailed explanations on how the new documentation system is supposed to
> work can be found at
> http://wiki.apache.org/cocoon/CocoonDocumentationSystemSUMMARY and at
> http://wiki.apache.org/cocoon/22NewDocuments.
>
> Please cast your votes!
>
+1 from me of course
--
Reinhard Pötz Independant Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc
--------------------------------------------------------------------
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Upayavira <uv...@upaya.co.uk>.
Reinhard Poetz wrote:
> Over the last weeks I've setup new documentation repositories in
> whiteboard/doc-repos. I want to make two of them
>
> cocoon/whiteboard/doc-repos/2.2 and
> cocoon/whiteboard/doc-repos/portal-block
>
> official documentation repositories. This means moving them to
>
> cocoon/trunk/src/documentation and
> cocoon/blocks/portal/trunk/src/documentation
>
> (Note that for now the repository at cocoon/whiteboard/doc-repos/global
> remains where it is, until it is filled with content and ready to
> replace the current repository at cocoon/site/src.)
>
>
> The new repositories can be build using Forrest 0.6 and the doctype of
> documents is HTML (for now, until the online-editing scenario is in
> available). Each document consist of a directory that contains the
> content (content_en.html), meta data (meta.xml) and a subdirectory
> 'files' that can contain resources like images.
>
>
> Before replacing the documents in cocoon/trunk/src/documentation,
> Upayavira will ensure that all docs that differ from the 2.1 docs will
> be saved.
>
> Detailed explanations on how the new documentation system is supposed to
> work can be found at
> http://wiki.apache.org/cocoon/CocoonDocumentationSystemSUMMARY and at
> http://wiki.apache.org/cocoon/22NewDocuments.
>
> Please cast your votes!
+1
Let's do it.
Regards, Upayavira
Re: [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Stefano Mazzocchi <st...@apache.org>.
Reinhard Poetz wrote:
> Over the last weeks I've setup new documentation repositories in
> whiteboard/doc-repos. I want to make two of them
>
> cocoon/whiteboard/doc-repos/2.2 and
> cocoon/whiteboard/doc-repos/portal-block
>
> official documentation repositories. This means moving them to
>
> cocoon/trunk/src/documentation and
> cocoon/blocks/portal/trunk/src/documentation
>
> (Note that for now the repository at cocoon/whiteboard/doc-repos/global
> remains where it is, until it is filled with content and ready to
> replace the current repository at cocoon/site/src.)
>
>
> The new repositories can be build using Forrest 0.6 and the doctype of
> documents is HTML (for now, until the online-editing scenario is in
> available). Each document consist of a directory that contains the
> content (content_en.html), meta data (meta.xml) and a subdirectory
> 'files' that can contain resources like images.
>
>
> Before replacing the documents in cocoon/trunk/src/documentation,
> Upayavira will ensure that all docs that differ from the 2.1 docs will
> be saved.
>
> Detailed explanations on how the new documentation system is supposed to
> work can be found at
> http://wiki.apache.org/cocoon/CocoonDocumentationSystemSUMMARY and at
> http://wiki.apache.org/cocoon/22NewDocuments.
>
> Please cast your votes!
+1
--
Stefano.
[RESULTS] [Vote] Make doc-repos/2.2 & doc-repos/portal-block official
documentation repositories
Posted by Upayavira <uv...@upaya.co.uk>.
Reinhard Poetz wrote:
<big-snip/>
+1: 8
+0: 1
Therefore, we're going to start working on the new documentation.
Firstly, I have brought all necessary changes from 2.1 into the 2.2
docs. So the 2.2 docs can form the starting point for our work.
Secondly, we will convert this documentation to HTML, put it somewhere
in the whiteboard/doc-repos in SVN, and then copy these documents one by
one to trunk/src/documentation.
It is this manual moving of documents from whiteboard/doc-repos to
trunk/src/documentation that we could use help with.
All it takes is reading a document (listed on
http://wiki.apache.org/cocoon/22NewDocuments), reviewing it to ensure
it is still correct and up to date, and moving it into place in
trunk/src/documentation, or deleting it if it is no longer relevant.
With just under 300 documents, if 30 of us did ten each, we'd have this
job complete pretty quickly!
We would then just need to fill in the gaps, and we'd have some lovely
new docs.
Regards, Upayavira