updated .md's, started adding informative YAML