word smithing, grammar bugs and making the linter happy