docs, preview, improvements to events