Adding docs and moving them around.  Deleted obsolete docs.
A large edit will now follow.