It could be very confusing when a user follow badly written documentation to achieve task. Especially if this task is important and the user is novice.

I will never forget how I spent 3 months of debugging and rewriting one of my applications with serial port support. Because of wrong howto that I followed I wrote an application that crashed every 2,3 hours. And after 3 months of debugging, testing, rewriting, reinventing the wheel I found the right howto. And that howto guided me to the right answer of my problem and the solution.