doc: fix typos, missing parentheses, upper/lower case

Fix some minor typos, add a missing parentheses and
unify some upper vs lower case words.

Change-Id: I2b6c394238de8d16f8eb4a752c2495762b01a2c3