Minor documentation update about usage of options and scope

- Be a bit more clear on the use of scope (fixing #322)
- Bring up the details on how to pass options