   # * `options` (optional) An options {Object} with the following keys:
   #    * `buttons` (optional) An {Array} of {Object} where each {Object} has the
   #      following options:
-  #      * `className` (optional) {String} additional class name add to the
-  #        button. It will already receive `btn btn-info`.
+  #      * `className` (optional) {String} a class name to add to the button's
+  #        default class name (`btn btn-info`).
   #      * `onDidClick` (optional) {Function} callback to call when the button
   #        has been clicked. The context will be set to the
   #        {NotificationElement} instance.
   #      * `text` {String} inner text for the button
-  #    * `description` (optional) A {String} that will be rendered as Markdown
-  #      to describe the notification.
+  #    * `description` (optional) A Markdown {String} containing a longer
+  #      description about the notification.
   #    * `detail` (optional) A preformatted {String} that will be rendered as
   #      plain text with details about the notification.
   #    * `dismissable` (optional) A {Boolean} indicating whether this

  # * `options` (optional) An options {Object} with the following keys:
  #    * `buttons` (optional) An {Array} of {Object} where each {Object} has the
  #      following options:
  #      * `className` (optional) {String} additional class name add to the
  #        button. It will already receive `btn btn-error`.
  #      * `onDidClick` (optional) {Function} callback to call when the button
  #        has been clicked. The context will be set to the
  #        {NotificationElement} instance.
  #      * `text` {String} inner text for the button
  #    * `description` (optional) A {String} that will be rendered as Markdown
  #      to describe the notification.
  #    * `detail` (optional) A preformatted {String} that will be rendered as
  #      plain text with details about the notification.
  #    * `dismissable` (optional) A {Boolean} indicating whether this

  # * `options` (optional) An options {Object} with the following keys:
  #    * `buttons` (optional) An {Array} of {Object} where each {Object} has the
  #      following options:
  #      * `className` (optional) {String} a class name to add to the button's
  #        default class name (`btn btn-error`).
  #      * `onDidClick` (optional) {Function} callback to call when the button
  #        has been clicked. The context will be set to the
  #        {NotificationElement} instance.
  #      * `text` {String} inner text for the button
  #    * `description` (optional) A Markdown {String} containing a longer
  #      description about the notification.
  #    * `detail` (optional) A preformatted {String} that will be rendered as
  #      plain text with details about the notification.
  #    * `dismissable` (optional) A {Boolean} indicating whether this
