formattting and scopes
minor read me changes