Mark is right

  • Post author:
  • Post category:Link

Mark Pilgrim is a smart guy, and he's right that the correct time to start writing is while you have that sense of wonder. That was the big difference in the approaches I took with the ImageMagick book (an attempt to be definitive and therefore boring to write), versus the MythTV book (a cleaned up version of my lab book notes from when I installed Myth and got it working nicely, with some other stuff added for completeness). The MythTV book was a lot more fun to write, and I don't feel nearly as burnt out at the end. Read more about Mark's burnout theory. So, I wonder what is next for me?

Continue ReadingMark is right

Random segue: how I came up with the original table of contents

One of the problems I grappled with early on with was how do you come up with a table of contents for a book? It's a complicated process, and it's really important. If the book doesn't flow, then people are left confused about what goes where, and the book is a lot less useful. Additionally, when you sit down to actually write, then you need to know what is covered where so that you can refer the reader to the right place to find out more about a specific topic -- even if you haven't covered that topic yet. So how did I come up with the first cut of the table of contents for the ImageMagick book? Well, I started by looking at all of the command line options to the various ImageMagick commands. I wrote this down on a stack of old business cards, and then distributed those cards in logical sounding piles on the floor. Those piles pretty much became the chapters that I originally submitted. That's the card mound. Anyway, once that was done, Matt (the editor) and I sat down and worked on the table of contents description until it flowed nicely, covered everything we…

Continue ReadingRandom segue: how I came up with the original table of contents

Chapter seven of the shop manual

  • Post author:
  • Post category:Link

"As he stared at her ample bosom, he daydreamed of the dual Stromberg carburettors in his vintage Triumph Spitfire, highly functional yet pleasingly formed, perched prominently on top of the intake manifold, aching for experienced hands, the small knurled caps of the oil dampeners begging to be inspected and adjusted as described in chapter seven of the shop manual" ABC coverage of the bad writing contest from San Jose University. [icbm: home]

Continue ReadingChapter seven of the shop manual

End of content

No more pages to load