new docs
Add a bunch of tests to make sure I got the behavior right in the docs.
Merge pull request #11 from erinspice/docs

Update docs and extend unit tests
fix lightswitch statechart image in README
fix hierarchical statechart image in README
Fix c/p error in reserved event docs & switch their h1 to h3.
Merge pull request #12 from erinspice/docs

Fix c/p error in reserved event docs & switch their h1 to h3.