mediawiki.notification: Return the Notification object from .notify calls

The implementation is solid, stable and already includes sanity checks
that make it difficult to shoot oneself in the foot.

This essentially makes the class no longer private; adjusted
documentation accordingly.

Bug: 57400
Change-Id: Icecc75e05a1f9a46e8de984c401a0292817d0d4c