more updates to clarify readme
adds new elements
adds additional tests and structural improvements