Update README.rst with details about unit tests

This commit just fixes a couple of issues with the README file and adds
some details about the OS_TEST_PATH env variable and unit tests.

Closes-bug: #1268440

Change-Id: I17f75f7d7b3a2ac75eac884bc403bc46d6a2e77f
1 file changed