Edited comments in .c .py and updated README

README and wiki document files under this branch. I wonder how this approach to documentation would scale when we start merging stuff!