doc update with output examples