pass on JSON config docs

some clarification, some simplification, some spelling, some just because.