Skip to content. | Skip to navigation

my settings

You are here: Home KnowHow NonProfit Lab Lab discussion How-tos Are how-to documents anyone can edit a mad idea?

Subject: Are how-to documents anyone can edit a mad idea?

Mark Barratt profile
Mark Barratt wrote on Nov 25, 2010

The how-to guides available in the Lab were started because of two things that are in KnowHow NonProfit's DNA:

  1. Listening to people working in smaller not-for-profit organisations, and
  2. believing that learning from one another - as well as from experts - is the most effective kind of learning.

From the earliest days of making this site with (we like to think) you, we have heard people generally praise the site content but add that what they often want is a quick set of instructions on how to do a particular task. Some jobs don't need to be understood, they just need to be done.

We knew what was wanted: a set of 'how to do X' articles. We guessed that users would know what it is they want to do (!), so we need a straightforward way of suggesting subjects. And we wanted to find a way of incorporating the experience of users that's better than the standard comment on the end of an article saying 'I did this and found that X is out of date' or 'you forgot to say that you need to have Y before you start'. 

The answer seemed to be a wiki, where anyone can create or edit text. We looked at ehow.com and other similar sites. We talked to people about Wikipedia (the best known wiki) and asked some typical KnowHow users to use it. They were baffled, and intimidated by the 'wiki markup' you need to use. Decided we needed to use a more Word-like editor.

We also have on our team a couple of opinionated people who think they know a lot about effective instructional documents (disclosure: I'm one of them) and they insisted that good procedural documents need to be quite highly-structured and consistent. 

That led us to a highly-mediated wiki, like a form, with embedded editor to allow rich text - lists, photos, etc. We tested our first go at implementing this in an actual usability lab with sample users. They were horrified.

There were two problems. First, we had made the creation/update process so 'directive' with several separate forms that users lost track of what they were doing and the context in which they were doing it. Once we'd seen that, the design response was fairly obvious (the result is the current process).

The other source of user poor reaction was deeper and rather more worrying. If we thought that familiarity with and acceptance of wikis was widespread we were very wrong. 'You mean anyone can edit this? Are you mad?' is a verbatim response from one user. 

Not sure how to respond to this. We've made the process as smooth and reassuring as possible (have we succeeded?) and thought about more issues of authority, traceability, post-hoc mediation than there's room to talk about. Version 2 is in the works with further small improvements. Now it's up to you to try it out and tell us if you think it's useful. And how to tempt in those who think that wikis are mad.

Log in or register to add comments

Mark Barratt profile
Mark Barratt wrote on Feb 03, 2011

Well, just to answer myself, the answer seems to be 'No'. People are starting to use the facility and to add how-to guides. Interesting that there are people who seem happy to create a how-to, and to comment on those which are added (for example on How to get your story covered in local media). But few are brave enough yet to start editing a la Wikipedia, apart from myself and KnowHow NonProfit's Madeleine Sugden - both of us a little obsessive about a misplaced comma or apostrophe.

The how-to experiment is therefore judged a success and the section has graduated from the Lab to the main part of the site. At the same time we have prepared a cocktail of small improvemnents based on user experience and wishes. They will go live in the next day or two.

Log in or register to add comments

ConsultantMGW profile
ConsultantMGW wrote on Feb 01, 2012

Oh dear. May I be brutally honest with you?

Erm... I think the HowTos are a fantastic idea. I'll get to that in a minute.

What I think is pretty awful is the layout of the forums.

Really, they're at the bottom of your site - you have to scroll down any time you want to visit them. They need to be at the top - so people know they exist. Visually, the way posts appear is off-putting. Walls of text, tiny font, difficult to add links or edit. It may explain why so few people are using the forum on a regular basis.

Sorry - that's my tuppence worth. Feel free to remove this post after reading.

Addressing the other issue - I think the NonProfit Wiki idea is brilliant.

I just think perhaps more people need to know about it.

You also need to make sure - as with Wikipedia - that you have some measure of quality control on it. When someone edits a HowTo, someone in the office gets a message and you can check it to make sure no one's said something completely inaccurate or inserted an expletive between the paragraphs. I'm sure you've got this already, anyway.

Other than that - definitely stick with it. Lovely idea.

Log in or register to add comments

Powered by Ploneboard