doc: now [optional] in the right place
added author revisions