fix up some descriptions to clean up opengraph
clean up lingo, examples, still need to add clarity between rules/standards