Documentation blues

-
I am currently in the midst of writing a software specification document and this is seriously draining my brain. ugh.

There is no doubt that specs are important to ensure we all agree to what we are developing, but writing them is oppressive. It would be easier to just sketch it out in a few narrative paragraphs, but that wouldn't be kosher. What is worse, is that it is for a GUI, which it needs even more details than usual, since it needs to interact with unpredictable users. sigh.

Comments

Colleen said…
Good luck, I will be checking back to see when you are done and back to blogging..
February 26, 2006 6:48 PM
Richard said…
Documentation is, for me, one of those mind-numbing things. Writing for pleasure is different, but writing documents that are complete, consistent, and testable is not.

As well, I’ve been moved to a different cubicle in the company (working on a different project). This means I’ve lost my fabulous view and now overlook a parking lot (should I care to look over my should and out the window). This cubicle is also far less private, so it is harder to surreptitiously dash off a few lines to my blog.
March 01, 2006 10:00 AM
Grumpy but sweet said…
hehe... trying writing documentation for 10 years... the only upside is the quitting is great.
March 05, 2006 7:59 AM
Richard said…
Ingrid, I think quitting is great from any job - of course, it helps to have something waiting for you (nice a nice big fat bank account. sigh.)
March 05, 2006 11:15 AM
Post a Comment

Popular posts from this blog

Chinese Wisdom Concerning Money

-
[19September-2007 @ 17:11 EST: Revised preamble. This page still gets the most search hits: There is no Anthony de Croud. The e-mail is SPAM. I post things that pique my fancy at the moment. I like the 8 precepts, but the rest of the e-mail is junk. However, I thought it fair to post everything in its entirety. I did not write the e-mail. I did not forward the e-mail. I strongly encourage you not to forward it either. (I also encourage you to reply to whomever sent you the e-mail and tell them you don't appreciate getting junk mail.)] Received this in our e-mail (English translation follows): PRECEPTO CHINO SOBRE EL DINERO EL DINERO PUEDE COMPRAR UNA CASA, PERO NO UN HOGAR, EL DINERO PUEDE COMPRAR UN RELOJ, PERO NO EL TIEMPO. EL DINERO PUEDE COMPRAR UNA CAMA, PERO NO EL SUEÑO. EL DINERO PUEDE COMPRAR UN LIBRO, PERO NO EL CONOCIMIENTO. EL DINERO PUEDE PAGAR UN MÉDICO, PERO NO LA SALUD. EL DINERO PUEDE COMPRAR UNA POSICIÓN, PERO NO EL RESPETO. EL DINERO PUEDE COMPRAR LA SANGRE, PERO
Read more

Risky Singapore?

-
CBC Radio had a documentary on Singapore and its lack of risk taking yesterday (only just heard it this morning). Since I know there are 1 or 2 Singaporean readers of this blog, I am curious to know how accurate the documentary is. I find that people often have mistaken impressions about other cultures and people. You can hear it here .
Read more

Why you should regularly visit your dentist.

-
I hadn't been to my dentist since May-2004 (normally I went on weekends, but since Sofia and the kids moved to Montreal, I am not in Ottawa on the weekends). Last night, as I was munching on some cashews, I felt a pain in one of my molars and then some grit in my mouth. I went and washed it out, assuming that maybe there had been a stone or something amount the cashews. Turns out I noticed a hole in the surface of the molar (top right, second from the back, my wisdom teeth were removed years ago). Fishing around for grit in my mouth, it looked like crumbled filling. So I assumed that my filling had cracked and crumbled and come out. Went to the dentist this morning, he took an x-ray and came back with bad news. I have a large cavity under the filling, which gave way. The filling did not fall out, but rather impacted into the space of the cavity. He did not rework the filling, since the cavity is very near the root - cleaning it out would likely result in exposing the root. As some
Read more