add docs and new README.rst
remove old readme file
update index and add intro and install sections
edit makefile to auto commit and index updates