document how to document optional arguments
