Tuesday, February 17, 2009

Berlinale Sprint 2009

I'm back for a couple of days from Jarn's first 10% sprint.

While everybody else was working on cool and exciting things, I happened to be in the wrong IRC channel at the wrong time. As a result Tres Seaver and me started to do something about Chris McDonough wining about old and unmaintained artifacts.

After a couple of days and nights of more work, you can now witness the new Zope2 Book - 2.12 edition. Finally we put an end to the confusing situation of the 2.6 edition being hosted at zope.org versus the 2.7 edition being generously hosted by Chris. The book has come home and is now available in a new and shiny form at http://docs.zope.org/zope2book/ thanks to Jens Vagelpohl.

Most of the time was spent converting the book from its old structured text source into a more modern reStructuredText format. With Sphinx and the design taken from docs.zope.org it was easy enough to produce the nice HTML output you see now.

We also did spent quite some time to update the actual content of the book and it is starting to be a valuable source again. The purpose of the book is still to introduce newcomers to Zope, who arent't full-fledged developers. It won't ever be a good guide on how to develop complex applications with Zope2 today. We weren't able to catch up on five years of history in the matter of days, so don't expect the book to be all new and shiny, but you will neither find ZClasses in it anymore and might be surprised to see links to the Python Package Index.

If you want to contribute to the book, the source material is available in the Zope SVN repository at svn+ssh://svn.zope.org/repos/main/zope2book/trunk. The web content is updated directly from SVN once a day. If you don't have commit rights, you can send patches or corrections to me and I'll gladly apply them for you.

Inspired by those activities Tres and Baiju M have also started to update the Zope Developers Guide and are busy converting it to reStructuredText as we speak.

The future of Zope2 is still looking bright ;)

Update: Baiju finished the ZDG conversion and it's available at http://docs.zope.org/zdg/. The links at http://www.zope.org/Documentation/Books/ have been updated by Jens.

If anyone feels strongly about the design, please get in touch with the Zope Foundation and the people behind new.zope.org. I'll not start tweaking CSS for one book here.

10 comments:

  1. This is great news! Thanks Hanno et al

    ReplyDelete
  2. Bravo! I look forward to pointing people at it.

    Just one thing: can we ratchet the green text a notch darker so it's easier to read against the white?

    ReplyDelete
  3. Great work! Now we just need a link from http://www.zope.org/Documentation/Books/ZopeBook/

    Oh, and +1 on making the link color a bit less headach-inducing. ;)

    ReplyDelete
  4. This is really great and was a really missing thing.

    ReplyDelete
  5. Here is the PDF version:

    http://www.zopyx.com/resources/Zope2Book.pdf/view

    ReplyDelete
  6. >>> hanno += 100

    Although I think I'll miss that part when training new people on Zope 2 when I introduce them to the Zope 2 book and they ask, "What the heck is a 'Plope'?!?"

    :P

    ReplyDelete
  7. Thanks for this great work! +1 to fix the link color. We have updated some links on the zope2 wiki.

    ReplyDelete
  8. Yay! Now, if we can only feed on the energy and finish the new nzo!

    ReplyDelete
  9. Hey many like you and me are also trying to explore Plone as much as possible. The only reason is we are all so fascinated by its versatility that it can be the most important face of Web technologies worldwide soon.

    The attempts are mentioned by one of my friend :
    http://bygsoft.wordpress.com/2010/01/18/howto-argouml-and-archgenxml/

    ReplyDelete