add documentation to README

added extensive documentation to README. probably subject to change but I wanted to get it written down.