[DOCS-12837] Add monitor title/description guidelines (#33663)

* [DOCS-12837] Add monitor title/description guidelines

* Add note

* Change callout type

* Move tables into procedure

* Fix indentation

* Add back an editorial change that got lost

Author: evazorro

content/en/extend/integrations/create-an-integration-monitor-template.md

@@ -63,8 +63,18 @@ After you've created and tested your monitor, add it to your listing in the Deve
 2. Click **Import Monitor**.
 3. Search for and select the monitor you created. You can include up to 10 monitors per integration.
 4. For each monitor, provide a **Display Name** and **Description**. These appear on the [**Monitors > Templates**][2] page:
-    - **Display Name**: A concise title that clearly communicates what the alert covers. Use active voice (for example, `Database latency exceeds threshold`).
+    - **Display Name**: A concise title that clearly communicates what the alert covers. Use active voice and start with the resource or metric followed by a verb (for example, `Database latency exceeds threshold`). Do not use template variables.
+
+      | Needs revision                                         | Better                                | Best                                          |
+      |--------------------------------------------------------|---------------------------------------|-----------------------------------------------|
+      | High Unacknowledged Messages reported on {{host.name}} | High Unacknowledged Messages reported | Unacknowledged Messages are higher than usual |
+
     - **Description**: A short explanation that helps users decide whether the monitor is relevant to them. Describe why this alert matters and what impact it addresses.
+
+      | Needs revision                                  | Better                                                                                                                                                                       | Best                                                                                                                                                                                                                                                         |
+      |-------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+      | Notify your team when unacked message are high. | Unacked messages are those that have been delivered to a consumer but have not been acknowledged as processed or handled. This monitor tracks the ratio of unacked messages. | Unacked messages are those that have been delivered to a consumer but have not been acknowledged as processed or handled. This monitor tracks the ratio of unacked messages to avoid potential bottlenecks which could lead to delays in message processing. |
+
 5. Click **Import**, then **Save Changes**.
 
 ## Further Reading