Fix syntax errors in user documentation
Add states documentation

Fixes #100