Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Revision as of 13:16, 25 October 2007 by kiran10182 (Talk | contribs)

Things to remember when writing Help text or Manuals

From Wiki
Jump to: navigation, search

Have you ever played a game where your partner tries to draw an object according to your instructions? S/he can't obviously see the object your holding and you can't see what s/he has drawn so far. It's quite challenging, actually. Much harder than it sounds!

When writing help texts and manuals you should remember that what you say can be comprehended quite differently than you expect. I once read instructions for removing a blade from a cutter. I tried to remove it but I couldn't complete the task. I asked a friend to remove it. He didn't do it like I did but still couldn't get the blade off. The person who had written the instruction ment to do it yet in another way! So, one instruction, three ways of understanding it.

96 page views in the last 30 days.