improved click handling + docs