A poorly written documentation, indeed no documentation at all, can turn completely unusable the best programs or package. Give here your opinion on what is desirable to do and what to avoid to write a good user manual.