Great Documentation – Go On Make the Effort!

One of my passions is great documentation. I take pride in my work on this front!

A lot of people simply hate the idea of having to write anything let alone an entire document. For me it is a place of calm, where I can structure my chaotic thoughts into a smooth and understandable picture regarding a particular topic.

As a reader, the first thing that strikes me when I look at any document is how it makes me feel. Corny maybe but this is the initial impression your work gives and provides the reader with a sense of comfort or discomfort around its content! Much like a first date, you would be less likely to accept a second if he/she arrived looking like they had spent little or no effort to look the part on meeting you!

So what is it that makes document great? Check out a few tips below:

1)      Firstly, does it look good?

As I eluded to earlier, your document is a representation of both your personal and company brand. Is it neat, well-structured and formatted OR sloppy, unstructured and all over the place. Try to avoid the following at all costs:

  • Use of multiple fonts and font sizes;
  • Unprofessional fonts;
  • Misaligned paragraphs;
  • Incorrectly numbered headings or items;
  • Different table styles;
  • Use of multiple colors. Use of color is great but stick to the color that resonates with your brand or logo.

2)      Is your use of language and the way you communicate good enough?

Nobody wants to read a 300-page document and often we can oversize a document by religiously following certain methodologies. Methodologies are great and each have their place but if you can say what you need with one diagram, for example, just do one. Likewise, keep your sentences as short as possible and stick to the point.

Double check your document for the following:

  • Bad grammar and incomplete thoughts or sentences (it happens more than you think!)
  • Spelling! There is spell check for a reason 🙂
  • Is there a better, more simplistic way to say or demonstrate the same thing?
  • Are there gaps in your logic?

3)      Does the information provided in your document have a natural flow?

It is highly likely that the person reading your masterpiece may not have any background into your industry, department, product or solution. This makes it important to provide detail in layers, starting with very high level to give context and then slowly breaking it down into more and more detail.

4)      Watch out for common template mistakes!

Whilst I am an advocate of using a good template where you can (it gives the writer the upper hand regarding content) watch out for the following:

  • If you are using a document that was initially for another client / service make sure that you remove EVERY instance of the previous naming. Failing to do so gives the reader the impression that you didn’t really have them in mind and this is a slap dash “copy paste” rendition.
  • Don’t just stick to the standard headings. Change them, add to them, they are unique – just like you and what you are communicating;
  • Be sure to update those pesky headers and footers.

Lastly, get someone you trust to proof read your document. A fresh pair of eyes can provide very useful insights.

Go Well



Where it all Began – Staying Positive!

This seems like the most appropriate first blog to give you, the reader, an insight into why I started. Writing has always been therapeutic for me and this is a fantastic outlet to share my thoughts, opinions and ideas!

Hope you enjoy the site!

November 2016…….

The last few years have been extremely tough. Seemingly wrong decision followed by wrong decision career wise and massive shake-ups in relationships, each resulting in severe blows to self confidence levels but duly followed by a period of frantic rebuild and repair.

Now, once again, I find myself faced with yet another career melt down.  Due to a merger of sorts, my current role, with all its promised future potential, has suddenly become redundant. Three steps forward, ten steps back it would seem, despite all the effort and personal sacrifice. For the last few weeks I have been wracked with feelings of resentment, anger, sadness and a multitude of other emotions – none of them good I’m sorry to say. Whilst I have done my best to manage these emotions for the sake of my team,  I am certain that there were days where I may not have been pleasant to be around.

As with most things in life there are always valuable lessons to be learned and it struck me that this kind of thing happens throughout every part of our lives not just our careers. Anyone who has been on a health and fitness journey or been in a difficult relationship of any kind would know what it feels like to work really hard at something only to feel like they are getting absolutely nowhere or, in some cases, further away from their goals! Frustrating right?!

In both cases we haven’t actually gotten ‘nowhere’. Its actually an amazing teaching ground. We learn about ourselves, our bodies, human behavior and emotion, our desires, our needs and our own limits. These times test our inner strength and resilience and equip us with new skill sets to meet new challenges in the future. Who has met someone really successful that hasn’t fallen a few times, if not more? Maybe it’s the universe pushing us to grow, to learn, change paths, find other ways to do things, become more human or seek new opportunities to reach our true potential.

I know that trying to keep a smile on your face when times are tough is really really hard  but consider how having a permanent bad mood could affect how you see a new opportunity or approach.  Consider how you feel about “Mr. Grumpy” for a second. Would you offer him an exciting new challenge? Would “Mr. Grumpy” even be able to hear it?

So to everyone going through a hard time of any sort – Chin Up and Stay Positive – Your Time is Coming!