should appear below title for consistency with the rest of the docs; also include :synopsis: