This is my most common feedback when I review docs that people have written.

The other is when someone write “if you need to do X” with no information about how you’d know if you need to do X