Add docs and some TODOs

- Add clarification for state transitions
- Reminder to remove some states
Add support for Attribute list parsing

- Add support for mixed content in Attrlist. To achieve that the parser
  upon encountering an attribute list will change into new mode
  in which it can process mixed content of attribute definition
- Add Quotes enum to support ending quotes when in mixed content