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.