Jeffrey P Shell: ZopeZope related topics.reStructuredText First Impressions- October 31, 2002 Today I started writing up user documentation for the project I'm wrapping up. It's the first time I've used reStructuredText, and I must say that I'm liking it. As far as structured text markup languages go, it's pretty comprehensive and not too obtrusive. It's definitely good enough for most technical documentation needs, and is in fact a PEP Formatting Standard (see also PEP 12 Source). Other items of interest, particularly to Python programmers, are: PEP 256 "Docstring Processing...http://radio.weblogs.com/0106123/categories/zope/2002/10/30.html#a228 Zope Stories- October 28, 2002 Zope Stories, another Zope weblog with some very good links and, well, stories.http://www.zopestories.com meta-whine- October 28, 2002 From Chris McDonough's Meta-Whine: With only few shining exceptions, these offers almost never pan out and the thing that they offered to do never actually gets done. It's as if people believe that by offering to do something, they've actually done it. Chris McDonough I have to plead guilty to this, with the most recent promises being a release of "FDoc". I learned my lesson long ago - fix it if I can, otherwise, stay quiet. There is rarely enough time in the day to do real work and Open...http://radio.weblogs.com/0106123/categories/zope/2002/10/28.html#a224 FDoc- October 27, 2002 I've been asked recently about this FDoc project I keep mentioning. Today, I wrote a new document about it. Regarding FDoc -- this is the new document, and goes over some of the design ideas as and after they've been put into use. Compound Zope Documents -- this is an older document, written a few months ago during some of the initial coding of the base framework and a default end-user implementation.http://radio.weblogs.com/0106123/categories/zope/2002/10/27.html#a223 Transitions in waiting.- October 23, 2002 I'm trying to transition back into posting. But - what to say I've been working hard during the day (and taking the pleasure of avoiding work when NOT at the office), where I'm away from Radio. I think it's time to move Radio Userland onto my iPod (and go - again! - through the pains of moving Radio) to keep it mobile (the path should stay the same, regardless of whether the iPod is attached to my workstation, my iBook (which is still going unused these days due to a SMC Wireless Barricade...http://radio.weblogs.com/0106123/categories/zope/2002/10/22.html#a221 |