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.
Things to remember when writing Help text or Manuals
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.