Add documentation for writing questions

- Add v1 doc section for writing questions
- Minor cleanup of the primary (non-readme) documentation file