Clean up some rec titles

Add json output

Update README.md

Make the titles a little better
* embed some apparently invalid yaml

Move metadata to top of resources