improve documentation and fix spelling errors
use JSON capitalization consistently