chore(docs): spelling and grammar
chore(docs): fix documentation typos.
refactor(all): use dart idioms