Documentation added.

Updated ReadMe and comments in the happiest_state.py