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

Of retirement and death

-
All I long for, all I have longed for for years is to retire (prior to wanting to retire, my ambition was to play). Given a chance not to work, I would take it. However, this is not because of laziness or some inherent trait of sloth. Rather it is because I want to pursue my own interests and ideas; I want to do my own thing. One of the saddest things I find in talking with people about not working (aside from obvious disapproval) is that they like working, they would get bored not working, after all, there is only so much TV one can watch. Hmmm ... a pretty sad comment I think. I have a mind full of ideas. There are lots of things which grab my interest, which distract me as I journey through life. Finding what I want to do is hard., because every week I can have a new thing I want to pursue. Some might argue that I am not disciplined. Definitely, I am a poor finisher - great starter, but lousy finisher. I believe I have found what my ideal job would be: owning and running an incubato
Read more

Half-and-half

-
Borrowing and modifying an idea from Ingrid , I present 14 bits of information about myself. Seven are real. Seven are false. This is also partially inspired by Carra 's post about weird things about herself. When I was into model rocketry, I used to roll my own rocket engines and make my own rocket fuel. I often had "catastrophic" engine failure. I have never been intoxicated. Not even a little bit "happy". I have had the privilege and pleasure of going out with women from every continent except Antarctica (for the obvious reason there are no indigenous Antarcticans). I volunteered one Christmas at a soup kitchen. I naively believed that such simple acts of generosity helped people over temporary setbacks until they could get back on their feet. The reality was these people were pretty wretched and needed far more than a ladled bowl of soup, a slice of turkey, some stuffing, mashed potatoes and cranberry sauce to get them "over the hump". It was a sta
Read more