Hi all,
I think this is where the PixInsight 'Wiki' pages come into play - that was really the fundamental reason behind them. The 'user manual' would be a globally cooperative effort, fleshing out the Wiki pages with our cumulative knowledge.
Once there was enough information there, Juan could start incorporating the information into the heart of PI itself.
Its either that, or - as Juan has said so often before - the whole development process of PI grinds to a halt, whilst the 'documentation' is written, published, read, assimilated, corrected, republished, etc., etc.
PI is too 'dynamic' for that in my opinion.
Cheers,