Updated Readme, Added docstrings, Fixed Examples

We can put the ```Available Resources``` section on a separate page of binpy website. I think it is creating a mess here in the ```README``` as it would get bigger with time.