Thursday, 14 November 2019

Documentation


My intention this morning was to walk into work, but I awoke to a deluge, it's dark and cold, so I think it may be a bus journey. Lots of thoughts going through my mind, a bit difficult to put into works because while not bad or downers they are not particularly positive and are the sort of thing that can put you on a downward path if other bad things happen.

It's another day, and another opportunity and I need to start on some documentation at work, effectively redoing documentation I have already written in a new template. Don't you find that often they template takes 75% of the documentation? The good thing about this is it's a single page, which will obviously expand when it's fleshed out.

I'm a great fan of a combination of white space and laconic text in documentation, because then, in my opinion, it's more likely that people will actually read it. Just like instructions for an IKEA flatpack , you think , sod it I'll just do it.

So as the black sky turns to grey the rain seems to have stopped, so why don't we go for "Have You Ever Seen The Rain" surely a rhetorical question by the brilliant Creedence Clearwater Revival.

This excellent video is part of the 50th Anniversary Vinyl Release (on the stripe below) , and I just love the lyrics to the song that opens with:

"Someone told me long ago 
 There's a calm before the storm
 I know it's been comin' for some time
 When it's over so they say
 It'll rain a sunny day
 I know shinin' down like water 

I want to know 
Have you ever seen the rain? 
I want to know 
Have you ever seen the rain 
Comin' down on a sunny day?"

Enjoy your Thursday my friends.

No comments:

Post a comment

Thanks for interacting