more documentation..
- added more to introduction & listeners