Changes based on feedback

- make behavior change rules obsolete
- documentation enhancements/additions
- example enhancements

Additional:

- fix erroneous interference with user stash when persisting events