Industrie Toulouse

	Wednesday, October 30, 2002

reStructuredText First Impressions
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 System Framework" (src)
PEP 257 "Docstring Conventions" (src)
PEP 258 "Docutils Design Specification" (src)

I include the source links to show the relative cleanliness of the markup, which is the point of all Structured Text formats.

sigh I thought I'd have more to say, but I'm really too tired. So - quick wrap up: I was pretty productive with this stuff right off the bat. Nice.

For Zope, there is a proposal to integrate reStructuredText into Zope, hopefully for 2.7.
10:10:23 PM blips[]

Snow and Summary
Big lovely flakes are falling outside, and it's really beautiful from up here.

It's been an odd week, and we're only two days into it. It would have been my Grandpa's birthday on Monday, and I went out to see my Grandma and ended up spending the night at her house. I slept in a room that my Grandpa finished when my dad had to move back home after my mother died. The cycle was strange. I was also given a wooden plaque of sorts that was made out of my Dad's first wedding invitation. It gives me two good things that I've never had before: a picture of my dad with a mustache, and a picture of my real mom who was very pretty (they were both in their early twenties in the photo. And I've never seen my dad with a mustache. Priceless).

The snow is getting heavier. I doubt this storm will bring any real accumulation, and ski season is still a couple of weeks off yet. But this is already a better start than last year - hopefully the snow really picks up (especially in the mountains) in November. And I've been waiting to see what a snowstorm would look like from up here.
7:30:36 AM blips[]

Navigation

Subscriptions