diff --git a/contribute/style-guides/documentation-markdown-guide.md b/contribute/style-guides/documentation-markdown-guide.md
index 83b886a9314..a17315968b6 100644
--- a/contribute/style-guides/documentation-markdown-guide.md
+++ b/contribute/style-guides/documentation-markdown-guide.md
@@ -121,10 +121,13 @@ _Do not_ use image shortcodes at this time.
 Include images in a document using the following syntax:
 
 ```
-![Alt text](link to image, starting with /img/docs/ if it is to an internal image)
+![Alt text](link to image, starting with /img/docs/ if it is to an internal image "Title of image in sentence case")
 ```
 
+> **Note:** Alt text does not appear when the user hovers the mouse over the image, but title text does.
+
 **Examples:** 
+
 - \!\[Grafana logo](/link/to/grafanalogo/logo.png)
 - \!\[Example](/img/docs/folder_name/alert_test_rule.png)