Docs: editorial cleanup, update examples and references, standardize formatting