[updates] Readme and File headers

Add a readme which is a great deal.

Updated the file headers (maybe missed a few)
Updated some typos and bits.

@wsnipex for review.