Move README.md to user_manual.md
Made docs/README.md be a directory of what we have.
Make top level README source links relative.

This way things work if you're on a branch.  Also fix link
to the user manual.
Show which arguments are optional