Bridging users & manuals creatively
Enter your email address above to be alerted when doQer goes live!

Posts Tagged ‘web 2.0’

The doQer Help Section: Eating Our Own Dog Food

Monday, July 13th, 2009

In parallel with the private beta testing that doQer is undergoing at the moment, we’re drafting out the “Help” text that will appear on the site to guide our users.

Of course, since doQer’s purpose is to host user manuals, all of the “Help” text will itself be contained in a user manual hosted on doQer. We’re eating our own dog food.

Making the manuals has actually been a very instructive process for us. As a developer it can be hard to put yourself in the shoes of the user, but using your own product for the purpose it’s indended, not just in a test scenario but on a real life project, really helps to identify areas for improvement.

User Manuals In The New World

Wednesday, July 1st, 2009

Picture Credit: Flickr User peterme (http://www.flickr.com/photos/peterme/)

We’re not alone in thinking that user manuals are stuck in the past. Over on the “I’d Rather Be Writing” blog, technical writer Tom Johnson examines the widening gap between how user manuals are presented today, and how modern consumers chose to obtain information.

In short, manual publishers are still churning out 200-page tomes and help files that look, according to Tony Self of HyperWrite, “the same as they did 15 years ago”, while customers are consuming information as tweets, wall posts, RSS feeds and a thousand other forms of abbreviation.

I think he’s hit the nail on the head.

This is exactly what we’re trying to address with doQer, although Tom outlines the problem more succinctly than I ever could, and indeed his post has given us further food for thought on improvements and new features that we could add to doQer.

The way forward, according to Ellis Pratt of writing firm CherryLeaf, is for manual publishers to begin “managing the diversity of information”. That’s a message we’ve taken to heart, and is behind a number of new feature ideas we’re mulling over.

The first commenter on Tom’s post, Febio Cevasco, also suggests some more solutions, which we’re already implementing with doQer:


“Allow readers to embed comments and feedback in documentation, which should then be sent to the authors”

This is one of the key features of doQer that we’ve already implemented for every manual.

“Improve accessiblity. Default search options in CHM and PDF are pathetic if compared even to traditional fulltext search. There’s also often no way to tag content effectively beyond a hierarchy”

doQer uses manuals in an open format, and allows search and instant conversion into various formats.

Be more integrated with the product (in case of software).

This is a broad demand, but doQer certainly increases the potential for product integration. For example, software programs can link directly to relevant sections of information stored within doQer.

Tom Johnson replies that “regarding the ability to embed comments and feedback in documentation, I thought this would be a bigger hit than my experience has shown”, so it will be interesting to see how it pans out on doQer. Either way, Tom’s post, and the comments it elicited, has given us plenty to think about.

Picture Credit: Flickr user peterme.

Suffice or Entice?

Tuesday, May 12th, 2009

The original idea for doQer was inspired, in part at least, by a fantastic blog post from Kathy Sierra, founder of the Creating Passionate Users blog, that contrasts how vendors treat their customers before the sale compared to after the money has changed hands.

Her juxtaposition between the glossy brochures handed out to “entice”, compared to the grey user manuals that merely “suffice”, starkly illustrates an outdated approach to the user experience that, as Kathy points out, vendors just can’t afford to take any more. Users are talking to each other after the sale, and discovering the opinions of others before they purchase. The quality of user manuals now influences pre-sale decisions more than ever before.

That’s why we’re building doQer: we want to help vendors provide a great user experience after the sale, by providing instructions in a variety of different formats so users can pick and choose how they access the information.

Kathy says “What if instead of seducing potential users to buy, we seduced existing users to learn? … Truly passionate users will evangelize to others”. That really encapsulates the value of doQer.

What’s doQer?

Monday, April 20th, 2009

doQer was dreamt up to solve a problem: user manuals are a pain.

If you’re a company that makes widgets, the last thing you want to worry about is creating a user manual for them. You want to focus on making your widgets as good as possible.

But the people who are going to buy those widgets need to know how to use them. So you have to create instruction documentation, often in many different formats: a printed manual that you can ship with your product, a PDF file that your users can download, some online help files for your website, and so on.

It takes time to create and maintain all the different formats. In many companies, the formats are maintained separately, so whenever a change or correction is required it has to be made separately to the printed manual and the online version.

doQer aims to solve that problem. We’re creating a web application that will allow vendors to maintain just one user guide document, and will automatically create all the different formats of user information just from that one data source.

Simple, but (hopefully) very useful. We’d love to hear your feedback on features that we should be aiming for, and how we can develop the idea further.