fix(README): cleanup lock documentation

accidently merged this without any review. Here are some more cleanups.
Merge pull request #400 from philips/add-lock-docs2

fix(README): cleanup lock documentation