Updated README and file comments

Signed-off-by: Ste Allan <steallan.web@gmail.com>