rose metadata: improve pattern documenation
Merge pull request #1318 from benfitzpatrick/more-doc-pattern-metadata

rose metadata: improve pattern documenation