Archive of the former Yahoo!Groups mailing list: MOTM

previous by date index next by date
  topic list next in topic

Subject: Beeeeeep.

From: Mike Estee <squeeker@...>
Date: 2005-06-10

This is a test of the emergency patch documenting system. Had this
been a real emergency, the patch you just viewed would have been actually
tested, and accompanied by an mp3 sample.

So, after all this talk of patches I got to thinking about a better way to
document them. I work on a mac (for some strange reason) and there is this
nifty little program called OmniGraffle which I use for work. It's like
visio for ya win32 people.

I decided to make a template set for the MOTM modules (others to follow!)
for documenting patches. It's not as quick as my usual method (camera
snapshot) but it is pleasing-on-the-eye, and a lot easier to read. The
template set currently looks like this: (took 3 minutes to assemble, fyi)

http://orbelisk.com/clickless.pdf

What do you folks think of this style? Yeah, I know it lacks labels but I
think it's a little less cluttered this way, only showing that which makes
the patch run. Comments? Thoughts? Any guesses why this is called
"clickless"? ;)

ps: i'll post the template file after a little peer review.

--mikes