Fix defaults and config (mostly reorder and docdoc)

Mainly re-ordering and documenting. Found a few missing if statements, missing variables, and obsolete variables along the way.

Now also dropping the argument_spec.yml thing which was getting really outdated and which doesn't seem essential. Related to #17.