Added lots of documentation, hopefully its good enough
removed docs from js directory, updated README instructions