improve make file documentation and tweak example code
improve documentation wording and spelling