add comments
updated events doc block
fix modals