First round of sorting out the sphinx documentation. Also updated readme file