big readme update - cleanup spec