add links to demo pages
update docs
begin adding some helper utility functions
document event firing order