* fix(docs): refactor and fix formatting * fix(docs): add missing options * fix(docs): change confusing link naming in README Closes #1272