Related Entries

Quick Ref: SVN command line
Git with Dropbox
Cisco's new urbanism
Portable development links
Wish I had this 10 years ago

« Fear of engineers and NRIs
» CVSTrac

Making of an O'Reilly book

Could there be a free and easy to use system for making technical documentation?

O'Reilly Net: “The making of Effective awk Programming”.

It has some great insights into the complicated world of using DocBook. There are some effective awk scripts that help. But the part that struck me most was, how insanely complicated it is to really use DocBook. I had written 2 tutorials using SGML, and 2 other multi-chaptered documents using DocBook. The tags and other rules make it very hard to let the thoughts flow freely.

My ideal documentation tool

Last week, I tried to program Leo using Python. It was not that hard. Only issue I faced was that I couldn’t make it work without a Leo window being open. This might be possible, but I don’t know how to do it yet. Batch processing on Leo files without the Leo GUI being open is very important to me.

Update: You can use Leo with reStructured Text.