Allow persistence of multiple event with a single persist call

- plus documentation and API doc revision/improvements