Friday, 29 July 2011

Documentation

I hate documentation - writing it that is. I really appreciate being on the receiving end of documentation (well, good documentation anyway) but I loathe writing it. My typical level of productivity is about a paragraph a day and, since I have 2 working days left to write both a final report and user documentation for a web site that doesn't seem like it will work.

Only thing worse that writing documentation is reviewing/assessing bad documentation - my eyes just slide off the page mid-way through sentences and my brain start throwing anything it can into the conscious thought-space to distract from the task at hand.

P.S. Think I need to change blog title from Ponderings to Grumblings.

Friday, 18 March 2011

Argh!

Do you know what I hate? I hate it when the boss says "it'll be easy, just use this code as the basis of the project - we want the same thing just a bit different." Then you find the code and you find out there is no documentation, no comments and it doesn't just install and run. So then you are stuck trying to work out what the hell the code does and why it doesn't work. And its written in a language you are unfamiliar with.

It sucks.