updating, markdowning, clarifying output