[Zope3-Users] Wiki proposal

[Shailesh Kumar]

Hello,

I had seen a site new.zope.org coming up sometime back which was using
Sphinx for the documentation of Zope 3. Though there was never a public
announcement of the website on this mailing list. The approach seemed
promising.  It somehow supported integration of work from multiple
contributers from different websites. For example, z3c.form documentation
was integrated from Paul Cauldner's website.  Unfortunately today it seems
that the website has gone somewhere else and I don't know where it is.
Further digging shows that its now accessible at http://docs.zope.org/. I
think I missed out when this change happened.

There seems to be another thing coming up (which I noticed today).
http://docs.zope.org/zopetoolkit/ . Seems like zope 3 is going to be called
zope toolkit from 3.5 onwards. I have accidentally discovered it today. This
site is also developed in Sphinx.

I am not sure what is the process for contributing to these documentation
websites

Overall, to me it seems that Sphinx based documentation is better compared
to a Wiki based documentation. One can focus on writing documentation using
simple text editors.

The http://www.zope.org/ website talks about becoming a contributor, but
thats focused on becoming a developer. May be some more information can be
provided for becoming a documentation contributor.

- Shailesh


On Fri, May 29, 2009 at 6:25 PM, Massimiliano della Rovere <
massimiliano.dellarovere at gmail.com> wrote:

> I was thinking about the idea of creating a wiki including classes,
> functions, examples and concepts about zope3, similar to the php
> documentation and more firendly than ++apidoc++
>
> If such a project were started, would you be interested in partecipating?
> _______________________________________________
> Zope3-users mailing list
> Zope3-users at zope.org
> http://mail.zope.org/mailman/listinfo/zope3-users
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.zope.org/pipermail/zope3-users/attachments/20090530/289cb126/attachment.html