Add docs for the notify kitten

docs/kittens/notify.rst

@@ -0,0 +1,43 @@
+notify
+==================================================
+
+.. only:: man
+
+    Overview
+    --------------
+
+Show pop-up system notifications.
+
+.. highlight:: sh
+
+.. versionadded:: 0.36.0
+   The notify kitten
+
+The ``notify`` kitten can be used to show pop-up system notifications
+from the shell. It even works over SSH. Using it is as simple as::
+
+    kitten notify "Good morning" Hello world, it is a nice day!
+
+To add an icon, use::
+
+    kitten notify --icon-path /path/to/some/image.png "Good morning" Hello world, it is a nice day!
+    kitten notify --icon firefox "Good morning" Hello world, it is a nice day!
+
+
+To be informed when the notification is activated::
+
+    kitten notify --wait-for-completion "Good morning" Hello world, it is a nice day!
+
+Then, the kitten will wait till the notification is either closed or activated.
+If activated, a ``0`` is printed to :file:`STDOUT`. You can press the
+:kbd:`Esc` or :kbd:`Ctrl+c` keys to abort, closing the notification.
+
+To add buttons to the notification::
+
+    kitten notify --wait-for-completion --button One --button Two "Good morning" Hello world, it is a nice day!
+
+.. program:: kitty +kitten notify
+
+.. tip:: Learn about the underlying :doc:`/desktop-notifications` escape code protocol.
+
+.. include:: /generated/cli-kitten-notify.rst