bookmark_borderGetting Organised

I read some advice the other day that suggested that, instead of reading up on how best to be productive, you’d be better served actually doing the things you need to do rather than trying to figure out the best way to ‘be productive’.

I guess the premise being that many people spend a lot of time researching methodologies, trying out applications and processes when, for most of the tasks they are tracking, they would be better to just do the damn thing already.

I fall squarely into that group of people. I’m very guilty of spending too much time figuring out the ‘best’ way to keep myself organised, sometimes at the expense of just doing things.

So, why do I even need any kind of system?

Well, mostly to counteract my awful memory but also, partly, to keep track of random ideas that float through my head, things I don’t need to act on straight away but I know are good enough to log somewhere with a view of revisiting them later.

But what do I actually need?

Let’s break things down. Fundamentally I need to keep three types of things organised:

  • Tasks
  • Information
  • Schedule

For all of these I want to be able to access them all from any device I want, be it my laptops (work and personal), my iPhone or my iPad. Simple enough, right?


There are tasks that I need to do and, broadly speaking, I can break them down across three categories: Work (capital W, day job), Personal, and work (lowercase w, side jobs).
Some of the tasks have a hard deadline (given to me, or driven by external forces), some of notional deadlines that I apply myself (or I won’t do them), and others fall into the ‘some time’ bucket (essentially these are the ideas that I need to follow up but which have no real urgency).

So I need categories, but I’m not fussed about sub-categories, and I need the ability to schedule repeating tasks because … well did I mention my awful memory?


Wunderlist. No, No, Reminders. Dammit.

It’s here where I struggle to find an ideal solution but I can see light at the end of the tunnel.

For now, I’m sticking with Wunderlist.

I love the app but there is no website (or OSX app) to allow me more power and easier editing. No matter how hard I try, this is a must have for me so after a couple of months of I’ve switched back to Wunderlist (I considered Remember The Milk again but it’s user interface just doesn’t feel nice any more). Wunderlist has iOS apps and and an OSX app, allows for categories and repeating alarms.

The future development of Apple’s Reminders app may sway me away from Wunderlist. Tighter integration with the OS makes it very slick and (work proxy issues aside) the ability to sync my Reminders to iCloud (and so across all my devices) makes it very slick. If the UI improves I can see it being my go to app in the future. Add in tagging, something I’m keen to see in the upcoming Mavericks release of OSX, and the power of the Apple ecosystem, across apps becomes a different prospect again. But that’s for the future.


There is also information I need to store. Be it documents of information, files to backup or share, lists of contacts, or other pieces of digital media that I need to keep organised.

Occasionally the information is snippets, not a full document, but the need is the same.


Dropbox – for file storage. Not just because I can access it from anywhere, and share folders with others if I need to, but because many iOS/OSX apps integrate with it, allowing me to use it for draft posts, for example, so I can work on them at any time. For the inquisitive, I’m using Byword on both OSes to write my blog posts these days.

Evernote deserves a mention here too. For shorter pieces of information, and particularly for clipping information from the web, it’s excellent. It means I can grab recipes, add to my Evernote powered wishlist, and just generally use it as a database of things that might be useful to me in the future.

I should also mention the Drafts app for iOS here. It’s a simple text based editor which has several ways to take what you’ve just typed and fire out an email, send it as a note to Evernote and more. It’s a good quick way ‘in’ to my information system.


Finally there is my schedule/calendar.

Due to personal circumstance this area is a lot more critical than it used to be, as I need to be able to schedule my leisure activities based on the whereabouts and plans of three other people.


Google Calendar – which allows me to share my own calendar and view those of others, making planning a night with one or more (or all) of those people a lot easier.


One item I’ve not included in this waffling ramble is email. Quite simply because I have an excellent solution.

Gmail + Mailbox

My personal email is all filtered into Gmail. I can access it anywhere I want on any device I have. Where the real bonus for me is that, by using Mailbox for iOS I can now manage my emails much better. If I can quickly reply, I will. If something needs followed up I can quickly schedule it to ‘reappear’ in my inbox.

And that’s where I am currently. I don’t stick to a productivity methodology, I try and just do things when I can, but for now I have a system that works for me and does get massively in the way of me actually doing things.

bookmark_borderWhy Fitbit is winning

My main aim for this year was to lose weight. Actually that’s not true. My main aim for this year was to be happy which involves changing my lifestyle and habits, mostly focussed around my fitness and weight.

Data helps me with this, tracking my weight loss lets me look back and see how I’ve been doing. To that end I invested in a set of Withings scales. They’ve been great and have really helped me keep focus, and given me that little spur I needed from time to time to get back on my bike, or go for a walk, anything to be a little more active. Aside from my happiness, losing weight is also something I must do as I’d really like to NOT be taking maximum dosage pills for my high blood pressure for the rest of my life. With that in mind I also invested in the Withings blood pressure cuff to let me do accurate readings at home.

Looking to accumulate all my ‘fitness’ related data I looked for ways to track my activities and, as I used it last year when I got my bike I re-installed CycleMeter to track that and looked into Fitocracy as a way to pull it all together.

It was about then I realised my system was a little flawed. CycleMeter only shares data with a single tracking service (Dailymile) which I don’t use… I remembered back to my running days (knee still gubbed so they remain in the past for now) and looked into RunKeeper. Built around an activity tracking service, it also has a GPS app for tracking runs and cycles… not as full featured as CycleMeter but all I really want is time and distance (and a map, that’s nice too).

I’ve spent a few weeks manually updating Runkeeper with the data captured by Cyclemeter (which I then need to manually pull into Fitocracy) and I’m a bit bored of it already. So it’s bye bye CycleMeter and Fitocracy, and hello Runkeeper.

It’s here I should also mention that I purchased a Fitbit a few weeks ago. It was more curiosity than anything but as a way to track, fairly accurately, who active you are throughout the day it’s been far more useful than I first thought. It also syncs with Withings (for my weigh-ins) and Runkeeper (for my activities). It’s also fair to say that it’s got the nicest interface/dashboard of any of the services I use. Withings is shockingly bad and slow to render, Runkeeper is somewhat dated already and really needs a UI designer overall.

So, Fitbit has fast become my hub, the central place where I track personal fitness data because it does what I need it to do and does a lot of that in the background with very little interaction from me.

The last piece falls into place as, thanks to the fact that Fitbit will sync data with MyFitnessPal which I’ve used in the past for logging what I eat and I have a good balance of automated data collection, all pulled together into one useful Dashboard.

It’s taken me a while to get to this point, not least because every single app or service I’ve tried has been good in some ways but bad in others. I prefer using CycleMeter but will put up with the deficiencies of Runkeeper to get the data sync’d automatically. I prefer interacting with Fitocracy than Runkeeper but it’s not quite there yet in terms of automated services (and is heavily geared towards weight pumping gym bunnies). Fitbit hits the sweet spot for me and given that I’ve dropped over two stones since January, it seems to be working!

Me on Fitbit

bookmark_borderDesign matters

Why would you choose to make something difficult to use? Are you deliberately putting barriers in the road? Or are you just forgetting the main reason why people pick up a document or manual?

Long ago, when I had just started out as a technical writer, I attended a course on designing for Print. It covered many things, from typography to layout and I still use some of the basic design rules I learned way back then.

Whitespace, choice of font, and hierarchical indentation can help make a document more readable. Clearly delineating the structure of a document without explicitly stating it as such, leaving visual clues to help the reader navigate the page (presuming you’ve covered the multiple navigation routes they’ll take to get to that page of information).

Such considerations will continue to become more important as more and more information is moved online, and is then available in a variety of media formats and devices. Structuring your content, and using visual clues to convey that structure clearly, will become ever more important.

At this point there starts to become an obvious overlap with usability, pushing technical writers to start thinking more in terms of the user experience than simple task analysis allows. Understanding the reasoning behind a user action will become equally important, and can be passed to development to influence the UI as well as directly impacting on how we present technical information in the future.

Beyond that I’m not sure where else this may take us but I do know that part of the reason I love this job is the cross-over we have with so many other professions/industries, and I can’t wait to see what is next over the horizon.

bookmark_borderUsability sucks

I’m getting royally fedup with a lot of what I read that is written in the name of usability. Maybe it’s just a personal loathing of the overly academic, or perhaps I lean towards simplicity a little too heavily but SHEESH, some of the better known experts can’t half prattle on…

I’m a member of the usability team at work, largely because I made a lot of noise about it when I joined the company, but also because as a technical communicator who is passionate about the entire experience of using a product, I realise that the interface is THE most important part of communication between user and product.

I’ll let that one sink in, shall I?

Despite our own protestations, we all know that while good documentation is crucial to a product, it’s the user interface that carries the bulk of the load of communicating the capabilities of the application. With that in mind it makes sense to be as involved as possible with the design of the interface for, as I read somewhere many moons ago, we [technical communicators] are “the interface to the interface”. So, if nothing else, getting involved in usability and screen (UI) design for your application should make the job of documenting the software a lot easier.

Now, I’ll happily admit I’m still very much a novice in this area, but I’ve picked up enough knowledge over the years to be dangerous. I’m very aware that my advice tends towards what I would consider common sense, but generally speaking I base my UI design comments, and generally usability thoughts, on the following processes:

  • Simple task analysis – picking out the main usage of the application should be pretty straightforward, but sometimes narrowing that down into distinct tasks can be trickier, so I tend to mentally “step back” everytime I approach a new screen and ask myself what it is I would WANT to be able to achieve given where I am in the application. Often you will find that the flow of the UI isn’t quite right.
  • Narrow your view – the next step is to pick out each control to make sure the label, text or icon make sense. It’s very easy to get caught up in the overall task and presume too much.
  • Quick, write something! – this step can be done mentally, with pen and paper, or just start typing. I often find that it’s only when trying to “tell the story” of how to use an application that all the pieces finally fall into place… and then you realise that one is missing.

As I said, I’m no expert but my approach seems to give reasonable results. Yes with formal analysis, metrics and so on, you can always improve things but sometimes perhaps good enough is good enough?

I sometimes wonder if I’m actually doing more damage than good so I’m quite careful that my opinion isn’t the only one (ok ok, isn’t the LOUDEST one), and I try and keep up with things – Boxes and Arrows & Jakob Neilsen for example – and I’m convinced that there is a big enough overlap between the two professions that one day I’ll be hiring a “usability writer”. No… a “technical usabilitist”…

bookmark_borderNo Docs = No Product

What of agile documentation?

It seems like such an old argument that surely, SURELY, doesn’t need revisiting? Alas it seems that the world of software engineering still contains those who think that code = product. Thankfully, in my experience, the numbers are thinning as most practitioners of modern software practices are at least educationally aware of the need for product documentation, even if they don’t fully understand the reasons. However, there are still those who are happy to hack away, and then claim they have a product. If you are such a person let me make one thing clear, you are wrong.

Not only are you wrong but as time marches on, you get further and further from being correct, all the while creating further problems for you and your product.

Just over a year ago, in preparation for my new job, I spent sometime reading up on Agile development and in particular I focussed on Extreme Programming (XP). The more I read the more I came to realise that this was an area which was popular with developers, yet had little to no mention of product documentation as a fundamental part of the methodology.

Mention of unit and acceptance testing as fundamental parts of working in XP suggested there was at least an understanding of the importance of solid, well constructed tests to help make to a “better” application (test-driven development) but the more I read, the more I become slightly disconcerted at the lack of consideration given both to the production of product (end user) documentation or of the benefits and skills a technical writer can bring to a development team.

Truth be told, I’ve still to find more than a passing reference in any of the more recent publications and articles I’ve found but I’m happy to be proven wrong. Perhaps I’ve been reading the wrong things, and visiting the wrong websites? Or, more worryingly, perhaps there really isn’t anything out there.

Obviously, as a technical writer, the role of product documentation as part of the product is something that is at the forefront of my mind, and I’m not expecting any software engineer to have to worry about such things beyond understanding that we are a fundamental part of the product offering and hopefully agreeing that there is a level of expectation setting to be undertaken.

That said, I do expect a software engineer to understand that software without any support, be it formal documentation, training, or a dedicated support team, is NOT a product. If we can’t agree that fundamental trait then perhaps that problem requires a solution (thankfully, as I said earlier, I don’t think it’s a huge issue at present).

Quite simply, products include documentation, support and training, and tell a cohesive story to a potential buyer. A story that says, yes this product will do X, Y and Z, and if it breaks we’ll do our best to help fix it, and we’ll support you as you learn to use it throughout the lifetime of your relationship with the product (and, therefore, the company).

Admittedly the lines are blurring, with better UI design there is less need for the end user to head to the documentation for assistance but I’d argue that, conversely, as UI design improves and more people become aware of the basic principles of software applications (we all know cut and paste by now, right?) then the end users will start to stretch the applications in ways that hadn’t been considered and it is at this point that product documentation (information) becomes the key differentiator between products.

Of course it is possible to happily exist as a technical writer in an Agile world, but I think we need our voice to be louder.

So I guess my question is, who is willing to shout?

Note: I am aware of Agile Documentation, but I’ve yet to read it. It seems to be more focussed on a developer writing documentation though? I’ll post a review of the book soon.