update docs on using yaml metadata to drive output format