The chief lesson I learned from working in documentation is that to a first approximation, *nobody ever reads anything.* Not just docs but also warnings in giant flashing red letters.
I did tech support and I needed a guy to send me a code generated by the program in question. I sent him a screenshot to show where it would be found and what the code would look like. He just sent me my own screenshot image back to me
People only really read documentation when they become aware of a problem and are looking for a solution, nobody ever just goes through the "before you start using this package" bits without a critical reason.