
"Pseudocode can be used to some extent to aid the maintenance
process.  However, pseudocode that is highly detailed -
approaching the level of detail of the code itself - is not of
much use as maintenance documentation.  Such detailed
documentation has to be maintained almost as much as the code,
thus doubling the maintenance burden.  Furthermore, since such
voluminous pseudocode is too distracting to be kept in the
listing itself, it must be kept in a separate folder.  The
result: Since pseudocode - unlike real code - doesn't have to be
maintained, no one will maintain it.  It will soon become out of
date and everyone will ignore it.  (Once, I did an informal
survey of 42 shops that used pseudocode.  Of those 42, 0 [zero!],
found that it had any value as maintenance documentation."
         --Meilir Page-Jones, "The Practical Guide to Structured
           Design", Yourdon Press (c) 1988
