docs(notifications): documentation for the notifications system

Fixes #7308

For some reason I really struggled to make the docs nice and helpful, so don't hold back criticism when you review.

 - [ ] Remove ``/1.9/`` from the http://reference.elgg.org links
```'notification:publish:object:photo'``` should probably be ```'notification:*create*:object:photo'```