[Zope-dev] zope2docs

[Andreas Jung]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 23.02.2009 17:45 Uhr, Simon Michael wrote:
> Andreas Jung wrote:
>> I moved most of the relevant stuff into SVN this afternoon:
> 
> Ok, were you able to clean up, ie delete, the obsolete content as well ?
>   I think this is an important step we need more of in Zope docs-land.

I think there is need for a volunteer or a dictator for docs.zope.org
before we can get rid of the old stuff. Most of the tasks for
docs.zope.org are low-hanging fruits:

 - the new.zope.org skins should be removed for docs.zope,org. Since
   all/most of the content will be auto-generated through Sphinx it
   should be sufficient to adjust the color scheme, putting a Zope logo
   on the page

 - bringing the documentation in the right structure. Right now we have
   in SVN:
   - zope2docs
   - zope3docs
   - developer_docs

  This could be the base for the final structure. Additional how-level
  hierachies could be:

   - tools (e.g. for Buildout)
   - packages (e.g. for the z3c. packages)

 - set up some mechanism for updating docs.zope.org regulary
   or manually (I think Jens is doing this manually right now)

 - after that: kick dev.zope.org, adjust the related links
   on the current zope.org front-page to their new location

Andreas


- -- 
ZOPYX Ltd. & Co. KG - Charlottenstr. 37/1 - 72070 Tübingen - Germany
Web: www.zopyx.com - Email: info at zopyx.com - Phone +49 - 7071 - 793376
Registergericht: Amtsgericht Stuttgart, Handelsregister A 381535
Geschäftsführer/Gesellschafter: ZOPYX Limited, Birmingham, UK
- ------------------------------------------------------------------------
E-Publishing, Python, Zope & Plone development, Consulting

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAkmi1ccACgkQCJIWIbr9KYxB9ACgklJVeaIdN+9zNOczLb+IHoPO
MfkAmwduXIZwRYfhP8rEETJYU3+6SQWe
=4qrN
-----END PGP SIGNATURE-----
-------------- next part --------------
A non-text attachment was scrubbed...
Name: lists.vcf
Type: text/x-vcard
Size: 316 bytes
Desc: not available
Url : http://mail.zope.org/pipermail/zope-dev/attachments/20090223/938475ab/attachment.vcf