Michel Pelletier wrote: >>I propose that we tolerate both approaches. Ultimately I think >>Martijn's view will prove right, that developers will jot things down >>in an Emacs buffer as they are writing code. >> >> > >Yeah, although I would say leverage and not tolerate. For component >design docs doctests are pretty superior (I recently got a good example >of this learning the Zope 3 catalog and its doctest) for designing, >testing and learning the thing, lots of bang for one buck. > >For overall design, user and feel-good docs nothing beets a good ol' >chapter outline developed into a chapter with technical and copy >editing. For this a tool like OO is more apropriate, although you can >get by with text in svn, it's a big hurdle for a copy editor to jump. > >Martijn's reference to the dogbowl is important. We should avoid those >mistakes, but I don't have an answer for that one. CPS may be fine >french cuisine compared to dog food, but if we start using it to write >doctests then we're getting it wrong. > >On the flipside, if CPS has cool OO integration then we can leverage >that to write prose-based material that needs polish. If we are writing >that stuff in raw XML then we are getting wrong again. > > > Hi! The OOo rendering looks really good in HTML, with a chapter index, internal links and everything. the site will be set up so that users will see the HTML preview as the default view. Users that are logged in will be able to download / edit the OOo document. >>However, I'm personally interested in the OO.o/Docbook approach the >>Julien described and will use it as soon as he gives me a login. >> >>Moreover, I think we should recognize Julien and Jean-Marc's >>initiative, just like we should recognize Philipp's initiative. I >>think the two directions can work together. >> >> > >Yeah I like the screenshots! > >-Michel > > Here are some new ones: http://www.medic.chalmers.se/~jmo/z3lab/screen4.png http://www.medic.chalmers.se/~jmo/z3lab/screen5.png and Julien is working on a Flash(tm) widget, so we'll be able to upload flash animations in documents. cheers /JM
Hosting: Nuxeo: Zope service provider