docs: clearer documentation on item events (#191)

docs: clearer documentation on item events (#191) #676