kcw | journal | 1999 << Previous Page | Next Page >>

I spent today at work writing up the next draft of our software architecture document. Now, I don't think I'm a terrible writer, but I'm not quick. It took me four hours to write the last 3-4 pages. It's a technical document so it has a lot of information for the amount of space used. Still, it was quite an arduous task.

I actually started last night and spent five hours rewriting a few pages. Last Friday I said that I'd have this document done by Monday morning. Pick, my manager, said I didn't have to get it done until Monday night. That was a bit of a mistake, maybe.

By rights, I'd have stayed up all night writing it up. Then been totally useless Monday since I'd be too tired to do anything. But I'd still go to work and attend the Monday meeting. Then I'd sleep a bit but try to leave at 15:00 or so to drive home and sleep.

The drive home would be quite an adventure. Almost impossible for me to stay up, constantly dropping off for a second or two. Suddenly waking up as my car is about to cross the lane. Trying desperately to stay awake. Singing, slapping myself, pouring water on myself. Then I'd drop off again for a second. I'd be lucky to get through the hour drive in one piece.

I can imagine it well because I've done it before. And it's not something I'd want to do again. But, if Pick wants something done by this date, Goddess help me but I'll get it done by that date. Unfortunately, as I did in school, I'll procrastinate a bit so that I have to pull a couple of long nights to finish on time.

Part of the reason is that Pick is a friend, and was a friend before he was my boss. And I hate letting a friend down. But another part of it is that he's a natural leader. He takes care of his people, works harder than any of us, and leads by example. It's hard not to do your best when the boss puts in 10 hour days.

So once again I'm writing our definitive document that explains our architecture, database schema, how we get data, what we do with it, etc. Everything I can think up. Naturally, there's been a lot of input from the other team members. We had meetings where I explained my ideas, heard their ideas, then we decided to go with my ideas. Most of the time.

I take stuff from other smaller documents that we've written. Then I write. Expand sections that are kind of vague. Back up statements with numbers of some kind. Spent a couple hours drawing a big diagram showing all our tables with the data flows in and out. Drawing pictures with Microsoft Word is a real pain. It's a slow program in the first place, it's slower in page view mode, you can't draw pictures in normal mode, and it constantly redraws the whole screen when I scroll around.

But anyway, I did get it done and mailed. Lots of little holes that we'll have to discuss tomorrow. Then another draft to fix those holes. And maybe fix some bugs from the previous release of our software.

Copyright (c) 1999 Kevin C. Wong
Page Created: August 16, 2004
Page Last Updated: August 16, 2004