DOC: minor changes: fix reference formatting, change wording