All software should have a good manual. Most programmers make terrible manual writers.

You've Nailed that !!!

There's a very old saying among very old computer programmers:  The purpose of writing a computer program is to write a good user's manual.  Programmers baffled by that zen koan make terrible computer programmers.