read me done!!
re-ordered a number of items to simplify

reading and documentation :)