   (let [{name :name
          full-name :full-name
          desc :description
+         docstring :docstring
          examples-htmls :examples-htmls
          examples-strings :examples-strings
          sign :signature
          related :related} sym-doc-map
-        examples (map (fn [html string] {:html html :strings string}) examples-htmls examples-strings)
-        popover-width  400
-        popover-height 400
-        popover-content-width (- popover-width (* 2 14) 15)] ; bootstrap padding + scrollbar width
+         desc (or desc docstring)       ; some symbols don't have a description so we use
+                                        ; the docstring instead; docstring is a regular string,
+                                        ; without markdown. Nonetheless, it will be passed to
+                                        ; md->react->component function to gain some basic html
+                                        ; formatting (like paragraphs)
+         examples (map (fn [html string] {:html html :strings string}) examples-htmls examples-strings)
+         popover-width  400
+         popover-height 400
+         popover-content-width (- popover-width (* 2 14) 15)] ; bootstrap padding + scrollbar width
     [popover-content-wrapper
      :showing? showing?
      :position @popover-position

   :children [[h-box
               :gap      "4px"
               :children [[title
                           :label "Docs"
                           :level :level4
                           :class "api-panel-popup-section-title"]
                          [md-icon-button

  [v-box
   :size "0 0 auto"
   :gap "2px"
   :children [(for [s signatures]
                [label
                 :label s
                 :class "api-panel-signature"])]])
