bookmark_borderOnce there was a man

The man was once a boy, and that boy remembers sitting in front of a large cream box which had a keyboard of mainly dark keys with a row of red ones at the top. He wasn’t sure why the television people had made such a thing but he enjoyed watching the items on screen move under his control.

A few years later that same boy was sat in front of a grey box which had a little smiley face on the screen when you turned it on. It made funny noises and took small rigid discs into a slot on the front just under the screen and had a keyboard and a mouse, all in the same colour. It had a little brightly coloured logo on the front and he remembers that the entire operating system fitted onto a floppy disc (an oddly named item that, by that time, was no longer floppy).

He used similar beige boxes for a few years and before he knew it he was working in an office and was using one all the time. It was grey and had was a little different to the ones the boy had used for all those years. He soon learned how to use it as it wasn’t that different from all the other ones he’d used before, although it was a little more confusing, even more so when a few months later he got a new thing for it which was even more different. But then it was 1995.

Since then the boy has finally realised he is a man, and until recently has stuck with those same kinds of computers, the one he uses at work was the same as the one at home and he learned many tricks to using it efficiently. He continues to use it at work and at home, but now he also has a different type of computer at home, one which reminds him of those early days and the smiley face and coloured logo. When he got the new computer he was quite excited, and spent a little too much time just faffing about with it but now he’s settled down and both the new computer and his old computer exist side-by-side happily.

However in the past few months the boy who is now a man has realised something. It’s not a new thought, and he’s pretty sure the purchase of the new computer put it to the back of his mind for a while, but he’s realising that these boxes, with all their wonderous capabilities, are starting to bore him. It may be what he is doing with them that is the problem, perhaps he is stuck in a rut and needs to reconsider how he spends his time but he now looks at his computers and sees what they really are, tools.

He wonders if he is bored of these things. Bored with staring at them all day, bored with how he uses them, and he wonders if he should put them away or embrace them fully and explore their hidden depths. He knows he will always come back to them regardless, but perhaps now is the time to refocus, rethinking and reconsider.

He wonders if he will ever return to the glee of seeing his first pixels dance across the screen, he wonders if this is a temporary lull like the ones before him, he wonders why he continues to return to this thread, suggesting there is something deeper, a fundamental realisation he has yet to grasp.

He decides to stop for now and wait and see what happens as, the boy now knows, time helps everything.

bookmark_borderA suburban weekend

Isn’t it amazing what a difference a little bit of sunshine can make, offering us a glimpse of another life, a different way of living. Memories of holidays rush to the fore, from the early morning birdsong to the dusky barbeques and glasses of cold wine, droplets of condensation glistening as they race each other down the stem.

Of course living in a suburban cul-de-sac there are certain things that need done on such a weekend and so the air is soon filled with the buzz of lawn mowers, the rip of hedge trimmers. People pottering around their gardens filling the air with the sounds of summer; a tranquil busy-ness fills the air.

Evening descends and the smells of summer build, the heady fragrance of a million blooms is joined by charred burgers and seared chicken. The clink of cutlery and laughter of friends join the throng, rendering past and future days invisible. The mood is light, playful and friendly, neighbours chat over fences, lowering their guard, everyone is smiling.

Such is the power of the sun.

We all know it will be gone by Monday, with tidy gardens, clean cars, and leftover food the only reminders. Watching the skies as the week progresses we hope for a repeat.

bookmark_borderRecently Read

A quick note this week: If you know of any blogs out there that focus on hardware documentation writing I’d love to hear about them. I’m keen to see if there are other topics being covered out there as I’m aware that my scope is defined by my current interests. Right, let’s press on.

Can online help show “read wear?”
Anne Gentle ponders on how best to show the online help topics which have the most traffic, and comes up with some interesting ideas:

“You could … show the most searched-for terms when the user searches. Concepts may be more easily connected when you understand what others were searching for.”

To my mind anything that helps people find what they are looking for is a good thing, and these more subtle, dynamic, pathways are a tangible advantage to delivering content online.

Do We Really Need Structured Document Formats? (Is Real Reuse Possible?)
Eric Armstrong investigates the many and varied aspects of structured authoring, and offers a balanced view of the pros and cons from his own point of view:

“I know from personal experience that it is possible to be “seduced by the capacity for reuse”, to the point that you over-engineer your docs like crazy, and take forever to deliver something “perfect” that would have much better received had it been much more imperfect, and much more rapidly produced!”

Can better technical documentation give your business a competitive advantage?

…technical documents – the user guides and help systems used regularly by customers – at the centre of the corporation-customer relationship, and calls such documents “value generators” as they help build trust and confidence.

Striving for Success in DITA Conversion – A Quick Reference
From Noz Urbina, some sage advice that I’m filing away under “Obvious but worth being reminded of”:

A lot of people see ‘project scoping’ as overhead that delays ‘production’, but it’s a classic example of ‘measure twice, cut once’.

A bit short and sweet this week, such is the price for a four day week though.

bookmark_borderDITA Maturity Model

I mentioned this in passing last week but having had a little time to delve into the model in a little more depth I thought it was worth re-visiting.

The DITA Maturity Model as an organic model that is still being developed. Rather smartly it’s presented in Wiki format allowing anyone who is interested to comment and debate any and all of the content.

The model itself follows a familiar pattern with six levels of maturity against which you can map where you and your organisation sit. However the DITA Maturity Model starts with the presumption that you are already committed to topic-based writing, and I think that’s a gap that needs to be addressed.

For me, the model allows me to explain to my boss (and his boss) why investing in DITA as a document schema is worthwhile but it misses the gap of why we should change what we are doing at all. Once you have made the leap, the maturity model is all well and good but MAKING the leap in the first place, well that can be considerably harder.

Of course I’m not the only person who realises this, and in steps the DITA Wiki which has an entire section on building the business case for DITA.

The DITA Wiki is interesting. Not only is it chock full of useful information but ALL the major players in the single source/content reuse arena contribute to the content and discussions. Again it’s telling that it grew up alongside the growth of DITA usage.

Anyway, the DITA Maturity Model is definitely worth a look if you are considering heading down the DITA road. If nothing else it will give you a better understanding of the road ahead, some of the pitfalls you will encounter and the benefits you will gain.

bookmark_borderHealth update

Just a quick one as I’m back from the doctors where my blood pressure (after 4 weeks of increasing amounts of an ACE inhibitor) is now 144/86.

The upper number (systolic) is easily changed, run up a flight of stairs and it’ll rise. Sit still for 20 minutes and it will fall. The lower number (diatolic) is harder to change so that’s the one I was focusing on, so I was delighted to see it well below 100.

Considering the readings that started all this were 196/122 then it’s fair to say that the downward trend is favourable.

Phew.