State representation doc fix.
Enforce (more) PEP8 and improve the documentation.