Ever wanted to just throw everything away and start over?
I’ve been tempted by this notion recently and, whilst it may seem a bit ill-conceived, part of me does wonder what would happen if we just, quietly, started removing some parts of our documentation.
In fairness, we’ve done that in the past. Our Development Kit has many aspects to it but, applying that old favourite 80/20 rule, we realised we didn’t need to maintain or even publish documentation on every single function point.
One of the reasons for the current line of thinking is that, quite simply, we have too much information. There are too many places to find information about our product, so we are refocusing and slimming down our offerings to make it easier for our customers.
This is a change of direction for us. When I first joined this company, to start building a team as there were no technical writers with the company when I joined, I inherited a lot of legacy documentation, not all of it particularly useful (my oft quoted example was finding one single page of documentation for a particular Tool in the Development Kit. One page for an entire tool packed with functionality, that you launch in the same manner as every other Tool in the Development Kit, which told you … how to launch the Tool. Useless much?). The challenge on joining was to improve the quality and coverage of the documentation.
And we’ve been very successful! We have a rich set of information available, but over time it has, as it always does, started to degrade. We have added more and more and, whilst we have consolidated where possible, the pace of product development here means we are usually hanging on to the coat tails of the next release.
So, with some changes to responsibilities and a shuffling of resource we are now in a position to take stock and start removing content and completely overhaul the structure of what we deliver. That will help improve findability (our main aim) and by focusing on the content that is really needed we can improve the quality as well.
It may also mean a change of authoring tool to support the outputs we want but more on that, later.
Gordon is currently reading: The Power of Habit: Why We Do What We Do and How to Change (Paperback)
by
Charles Duhigg
Gordon gave 5 stars to: Spit (Paperback)
by
Stephen Watt
Gordon gave 4 stars to: Steve Jobs (Hardcover)
by
Walter Isaacson
We did done a holiday!
We had a few simple criteria for our holiday. It needed to be under £500 each, it needed to be somewhere hot and sunny, and ideally it needed to be all inclusive.
After various online searches, we had it narrowed down to a week in Cyprus, or a week in Tunisia. Icelolly.com helped keep the price to just under £400 pp and we ended up picking Tunisia as it was a bit different (and Kirsty has been to Cyprus before).
It’s safe to say we lucked out and had a fantastic holiday!
We stayed at a hotel that was built in the 1970s, built in the style of an old Medina, mostly two stories tall and sprawling over the area of a small town, it was Tunisian to the core. Driving past other hotels in the area (Yasminne Hammamet) and I have to admit it was nice to be in one of larger hotels (the more typical Costa del Sol style, 6-8 floors with boxy rooms).
The room upgrade helped too, of course.
I’ll admit that I wasn’t quite sure what to expect from Tunisian but I’d heard good things about the country and the people. I wasn’t proven wrong. The Tunisian people were friendly and, with a few words of faltering Arabic, always ready to help with a smile and a laugh.
The hotel itself was great, the staff efficient and an enthusiastic ‘animation’ team meant there were plenty of activiteis for us… to largely ignore (we did a bit of archery but our focus was to be lazy!), the food was great and well enough varied that you never got bored, and the sun did it’s bit and for the most part shone brightly, keeping things at toasty 28C or so (we think we topped 30C one of the days).
I ate camel steak, bartered in the souk (and no doubt still got ripped off), visited Carthage and Sidi Bou Said, had a wonderful Turkish Bath and massage, and did a whole lot of lazing around and chilling out.
In fact the only negatives were the security queues at the Enfidha airport, but such is life.
I’m back home now, feeling properly relaxed and upbeat, with a reasonable tan (we were only there for 7 days) and a desire to go back again. The resort itself is very similar to Andalucia, there is a Moorish influence to be found, and a similar climate. Learn a few basic Arabic phrases and don’t get put off by the sellers in the souk, it’s part of the fun to chat with them and avoid getting dragged into their stores ‘just for a look’.
I’d happily, highly, recommend it for a sunshine break. Yes, it was a package holiday, but with excellent customer service, it really did feel like we got a lot of value for our money.
Some of our memories of Tunisia.


Rabbit Foundling Ruediger Sleeps on Keeperâs Hand
Photos by Rolf Vennenbernd, who wrote the following:
Rabbit foundling Ruediger sleeps on the hand of keeper Kristina at the zoo in Muenster, western Germany, on April 4, 2012. Ruediger, weighing 72 grams, and his sister Kaline (60 grams) were found in a dung pile at the zoo and are brought up now by keepers.
Photos via
It’s Friday the 13th (still!) what better day to announce that the new ISTC website is going live.
I have just updated the domain nameservers to point to the new website. It can take a day or so for these things to propagate through the Internet so it might not appear immediately for everyone.
If you experience any problems or spot anything that needs corrected please let me know.
I have still to upload all of the InfoPlus and Communicator archives, but aside from that, the rest of the content should be available.
But thought I’d say hello.
Gosh, quite a lot has happened in the past, what, 10 days.. hang on, IS THAT ALL? Blimey.
So, I bought a new car. It’s blue (Horizon Turquoise Blue to you). It’s a hybrid. It has a few nice gadgets. It’s quite small. It’s rather bloody lovely and looks like this:
Honda CRZ.
That website is about to get switched on so I will have a fair bit less stress and will finally be able to build my Lego Space Shuttle (my promise to myself for getting it launched… see what I did there…).
I’ve lost some more weight.
Then put some of it back on.
Then lost some more. The trend is still downwards but I also ended up on antibiotics so I’m not disheartened. Determined still!
I have also toyed with writing up my own inner thoughts as I continue to battle to lose weight, largely prompted by reading The Skinny Conspiracy which, if you battle with your weight, or an eating disorder, or just generally struggle with your own body image, then you might want to give it a read.
Ohh yeah, and one of several PPI claims came back with a settlement figure that was a VERY nice surprise (five figures nice!). So my ex-wife and I get a nice wee pot of cash. Smiles all round for that one.
Anyway, can’t stop. Website to launch and need to read up on my holiday.
Oh yeah… off to Tunisia at the start of May… didn’t I mention that?
Early Bird Special: When Nike gave Internet video maker Casey Neistat a hefty advance payment and orders to #makeitcount, itâs unlikely this is what the company had in mind. Nicely done.
[youtube]
April?
APRIL!
What the…
How does this happen?!
Anyway, life continues apace (it seems). Holidays are being booked, cars being pondered, and still in the background a website remains unfinished. Must. Get. It. Done.
Weight continues to fluctuate, the last two weeks I’ve been ill (again) and as the course of antibiotics finishes I’m getting back on track, and back on my bike. Need to get rid of 5kg ASAP!
I know I work best when I have a goal so my first is a 50-mile pootle along the Forth & Clyde canal on the 20th May. Plan is to cycle to work a few times, and hopefully fit in a couple of weekend cycles from Glasgow to Balloch as well to get my legs moving. Add in a few games of basketball, the occasional game of badminton and I should be back on track in no time.

onemantales.co.uk
flickr.com/photos/gmclean
gmclean.tumblr.com
last.fm/user/snowgoon
Instapaper RSS Feed
Pinboard/gmclean
goodreads.com/gmclean
gordon.mclean [at] gmail.com