docs: add readEvents() to core overview