You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Carsten Ziegeler <cz...@apache.org> on 2006/05/14 12:30:52 UTC
Re: Cocoon 3.0 documentation started
Reinhard Poetz wrote:
> You may wonder why I need separate collections for all blocks and the core.
I'm wondering if this is a good idea? Does this mean that we have
another doc for each block? It seems to me that we are struggling a
little bit with getting the docs right for 2.1 and 2.2, so adding yet
another version imho does not help.
Carsten
--
Carsten Ziegeler - Open Source Group, S&N AG
http://www.s-und-n.de
http://www.osoco.org/weblogs/rael/
Re: Cocoon 3.0 documentation started
Posted by Reinhard Poetz <re...@apache.org>.
Carsten Ziegeler wrote:
> Reinhard Poetz wrote:
>
>>I think you misunderstand what daisy collections are. I introduced this new
>>collection to mark all documents that belong to the cForms block. That's
>>necessary to write a M2 plugin (at least I don't know of any better solution).
>>This also means that *no* new version of an existing document was created. The
>>menu entry "Blocks - Forms" is only a reference to the cForms docs.
>
> Ah, thanks for the info - than I'm fine with that.
>
>>All new documents that I created are documents that only make sense for Cocoon
>>3.0 and I don't think anybody has a problem with more documentation - especially
>>if it was requested many times ("I would do more for Cocoon if I know where to
>>start from ...")
>
> Noone stated that he might have problems with more docs - all i want is
> as few version
> as possible of a single documentation.
fine, then Daisy is the perfect solution for this requirement :-)
--
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
Re: Cocoon 3.0 documentation started
Posted by Carsten Ziegeler <cz...@apache.org>.
Reinhard Poetz wrote:
>
> I think you misunderstand what daisy collections are. I introduced this new
> collection to mark all documents that belong to the cForms block. That's
> necessary to write a M2 plugin (at least I don't know of any better solution).
> This also means that *no* new version of an existing document was created. The
> menu entry "Blocks - Forms" is only a reference to the cForms docs.
Ah, thanks for the info - than I'm fine with that.
>
> All new documents that I created are documents that only make sense for Cocoon
> 3.0 and I don't think anybody has a problem with more documentation - especially
> if it was requested many times ("I would do more for Cocoon if I know where to
> start from ...")
Noone stated that he might have problems with more docs - all i want is
as few version
as possible of a single documentation.
Carsten
--
Carsten Ziegeler - Open Source Group, S&N AG
http://www.s-und-n.de
http://www.osoco.org/weblogs/rael/
Re: Cocoon 3.0 documentation started
Posted by Reinhard Poetz <re...@apache.org>.
Carsten Ziegeler wrote:
> Reinhard Poetz wrote:
>
>>You may wonder why I need separate collections for all blocks and the core.
>
> I'm wondering if this is a good idea? Does this mean that we have
> another doc for each block? It seems to me that we are struggling a
> little bit with getting the docs right for 2.1 and 2.2, so adding yet
> another version imho does not help.
I think you misunderstand what daisy collections are. I introduced this new
collection to mark all documents that belong to the cForms block. That's
necessary to write a M2 plugin (at least I don't know of any better solution).
This also means that *no* new version of an existing document was created. The
menu entry "Blocks - Forms" is only a reference to the cForms docs.
All new documents that I created are documents that only make sense for Cocoon
3.0 and I don't think anybody has a problem with more documentation - especially
if it was requested many times ("I would do more for Cocoon if I know where to
start from ...")
--
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