Poorly written documentation, indeed no documentation at all, can turn completely unusable the best programs or package.
About documentation file format: man, chm, html, xml, pdf something else?
About documentation tools: editors, screenshot utilities, i18n...
About content itself: what is desirable to do and what to avoid to write a good user manual.
Please give here your opinion, your own choices and why.