A clean step-by-step guide is easier to follow, but only until something goes wrong. Adding every possible error can make the main instructions hard to find.
How do you decide which problems belong in the guide itself? Do you link out to separate fixes, or keep everything close to the step where people get stuck?