Docs: add more info about reading hal pins

Signed-off-by: John Thornton <jthornton@gnipsel.com>
Docs: fix some spello's
Hope I didn't change the meaning of anything.

Signed-off-by: John Thornton <jthornton@gnipsel.com>