switching to .yml for docs data. grammar and link corrections