Improve readability of FSM user documentation
- restructure semantics section: defined subsections, example-based, progression from simple to advanced
- clearer separation between "standard" room semantics and etrice extensions to semantics, e.g. handlers
- minimize description section (replace wikipedia quote with just the link)
- fix grammar and typos