-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 robert rottermann wrote:

thanks a lot for the effort that has been put into the new zope documentation. I have a litte wish: the colors of the index (light green on whit) is uncomfortable to my eyes and hard to read. maybe this could be changed to a more contrasting combination?

+10 from me. Readability should trump "design" every time.

Andreas Jung schrieb: In preparation for the upcoming Zope 2.12 release we reorganized the Zope 2 documentation:

- all related documentation is now maintained a restructured text document in SVN:

svn+ssh://svn.zope.org/repos/main/zope2docs

- The Zope Book, The Zope Developers Guide and some ZODB articles have been converted from STX to ReST

- The Zope 2.12 doc folder has been restified and is included within the zope2docs folder through a svn:external

- The Zope 2 specific documentation including releases notes will be generated in the future using Sphinx from 'zope2docs2' and published on docs.zope.org

Thanks to Hanno and Tres for reSTifying the Zope book and the ZDG.

Baiju did the main work on the ZDG: I just slurped the TTW content into SVN. - -- =================================================================== Tres Seaver +1 540-429-0999 tseaver@palladion.com Palladion Software "Excellence by Design" http://palladion.com -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFJoDkM+gerLs4ltQ4RAnJpAJ0QU3r6CwP08WtWX4iMqw5XhZA2SwCgkb9W S57lPagcGIZslydxGGZcvx0= =GooC -----END PGP SIGNATURE-----

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 23.02.2009 17:12 Uhr, Simon Michael wrote:

Reinout van Rees wrote:

...

And: I don't mind doing a bit of this work. But: I'm getting a bit lost in the various websites (old/new/unfinished/never_started).

Absolutely, we need a map.

...

http://www.zope.org/DevHome/ The stuff to be moved to svn.

Andreas, fwiw I don't think that is a wiki, but http://zope.org/DevHome/Subversion is. I have a list of http://wiki.zope.org/WikisStillOnZopeOrg . Perhaps more of these, at least the non-member ones, should move either to sphinx/svn or to wiki.zope.org. Consolidation is good.

I moved most of the relevant stuff into SVN this afternoon: http://svn.zope.org/developer_docs/trunk/source/ I've rewritten parts of the documentation, other stuff must be rechecked - - especially the stuff about becoming a contributor. I am definitely in favor for moving/maintaining such such in SVN. Sphinx allows us to structure the documentation the very well (especially hierarchically) and it provides a powerful pipeline for generating nice looking output (HTML/PDF). Andreas -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (Darwin) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iEYEARECAAYFAkmizlsACgkQCJIWIbr9KYyqqwCePiNs1q4mW9YpwtporagQ2Wqc 5v0AoMcFVtez2WxAD8IWN0UZiFn2m/h3 =27Zq -----END PGP SIGNATURE-----

-----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@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-----

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 21.02.2009 15:26 Uhr, robert rottermann wrote:

thanks a lot for the effort that has been put into the new zope documentation. I have a litte wish: the colors of the index (light green on whit) is uncomfortable to my eyes and hard to read. maybe this could be changed to a more contrasting combination? robert

docs.zope.org is definitely only a interim solution (see broken links in the tabs). I think it should be a long-hanging fruit bringing docs.zope.org into a reasonable state since we csn auto-generate a bunch of documentation directly through Sphinx. Andreas -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (Darwin) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iEYEARECAAYFAkmhl7gACgkQCJIWIbr9KYwlDgCgkEpsmlmrIxz3jn6Ar6k8uGU/ 1d0AnAhZRAmwD3/+1kDcJWnCvb31rwGs =bnqU -----END PGP SIGNATURE-----