Option documentation updates

Also split out into OPTIONS.md and keep README.md a little shorter.