Docs: added events, updated API and cleaned up

@jtsoi, @vs-ab, @zyniq82 have a look …