-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Stephan Richter wrote: > On Friday 13 May 2005 14:51, Julien Anguenot wrote: > >>>I myself tend to prefer restructured text documents in a svn repository >>>for lightweight design that's tied in with code, as that is easy to >>>edit, diff and version control, and easily accessible developers. Having >>>the other artifacts near that makes it easier to manage. The advantage >>>is that it's simple and that most people involved already know to deal >>>with this. >> >>-1 for me on rst documents for specifications and design docs. >> >>My idea with Dockbook and OOo is that we'll be able to have a >>documentation quite easily in various formats and provide it directly to >>the public while writing them. Nobody's in the Zope commnunity is really >>good at documentation because we don't have a lot of available >>ressources for writing it. (maybe Plone is an exception on this ;) ) > > > I am for using ReST. BTW, it is not true that the Zope community is bad at > writing documentation. Have you seen the README.txt files in Zope 3 recently > and especially their compilation in the "Book" module of apidoc? Please don't > make me write OpenOffice documents or XML. ReST is just fine; the other > choice would be LaTeX of course, but I think this would be overkill. Sorry Stephan. I ment : CMF / CPS communities.... You did an amazing work with the Z3 book. So my apologies big time for this ! Latex would be overkill for sure ;) I like Latex a lot as well but I don't even want to propose this since I can already hear people screaming ;) J. - -- Julien Anguenot | Nuxeo R&D (Paris, France) CPS Plateform : http://www.cps-project.org mail: anguenot at nuxeo.com; tel: +33 (0) 6 72 57 57 66 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org iD8DBQFChjeJGhoG8MxZ/pIRAgA5AJ4gkFRSS08VUWpYpn0BGgFxXTB8fQCcD7TK a65WkhTGPcPZhNZ2F52Hiz4= =xMx0 -----END PGP SIGNATURE-----
Hosting: Nuxeo: Zope service provider