document writing documentation for optional arguments better
