+ update some phpdoc
+ provide support for softDelete methods on elements for custom behaviour when events deleted