And why do they put in random pictures clearly copied from other manuals
So, planning on doing some work on my bike, I'm looking through the list of instructions in Haynes.Ok, do that?No problems. Unscrew this?Simple. Move that out the way?Easy.Remove the rear shock?Piece of ca...Hang on? What?! You could have mentioned that at the start, instead of casually chucking it in at about stage 8 of the process...!!
Somebody probably lit a fag with it
When writing manuals, I often explicitly recommend how they should be used - similarly to what I listed here. After having read this post, I'm even more convinced that it is good to state the "manual for the manual" right at the start.
Quote from: Slaninar on 28 April 2020, 04:03:58 amWhen writing manuals, I often explicitly recommend how they should be used - similarly to what I listed here. After having read this post, I'm even more convinced that it is good to state the "manual for the manual" right at the start. I've written rules for Board Games and one of the most important parts is what's called "Blind Play Testing", where you hand the game and rulebook to a bunch of people who've never seen it before and sit back and listen.You make notes of them saying "Hang on, what does that mean?" or "How do you do this?" or "Can I do that...?" and check that they can find the answers in the rulebook.If they can't, you need to rewrite the rules and/or add examples to make it clear.IMO this should be the case for *all* manuals
Though, I've had experience that some people ask about very simple instrucitons (like one A4 sheet of paper text, with clear, step by step instructios).So the question is - did you aim for 100% question free, or just aimed for some threshold (like 95% or similar)?