Devoncarew readme2

Fix #33, #24.

Add some docs to the readme and improve some class dartdocs.