cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Derek Hohls" <DHo...@csir.co.za>
Subject Re: State of the documentation effort
Date Wed, 13 Apr 2005 06:57:46 GMT
Reinhard

This looks good - what still seems to be missing is an 
overall information structure - the "wood" and not the
"trees" - for me, assessing the detail is much easier if
I can see the big picture.  I also think it makes it easier
to see if new pages eg. from the wiki, need to be added
in to help complete the information structure.

[sidebar: it is suggested on the page :
http://wiki.apache.org/cocoon/CocoonDocumentationSystemHowTo 
that users should "add a note at the top of the page that 
you're working on moving it to our official documentation"
how about allowing users to suggest pages that should be
moved, and let the docs team decide if they need work on?
Maybe try and have standard way of annotating this?]

Thanks
Derek


>>> reinhard@apache.org 2005/04/13 08:25:31 AM >>>
Derek Hohls wrote:
> Upayavira
> 
> Is there any possibility of putting drafts of the new framework
> on the Wiki (perhaps with notifications of major updates on
> the mailing lists)? - I think this is the easiest and fastest way to
> get people's comments.

See

  - general information
    http://wiki.apache.org/cocoon/22NewDocuments 

  - build the new docs
    http://wiki.apache.org/cocoon/22NewDocumentsGeneration and
    http://brutus.apache.org/docs/build/cocoon-2-2/ (new structure)

  - the infrastructure
    http://wiki.apache.org/cocoon/CocoonDocumentationSystemSUMMARY 

HTH

-- 
Reinhard Pötz           Independent Consultant, Trainer & (IT)-Coach 

{Software Engineering, Open Source, Web Applications, Apache Cocoon}

                                        web(log): http://www.poetz.cc 
--------------------------------------------------------------------


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@cocoon.apache.org 
For additional commands, e-mail: users-help@cocoon.apache.org 



---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@cocoon.apache.org
For additional commands, e-mail: users-help@cocoon.apache.org


Mime
View raw message