Added yet more detail and clarity to documentation
Clean up typos in options configuration