Merge pull request #1723 from serialc/patch-1

Author: cderv

docs/authoring/callouts.qmd

@@ -26,19 +26,17 @@ Callouts provide a simple way to attract attention, for example, to this warning
 :::
 
 ::: callout-important
-## This is Important
-
-Danger, callouts will really improve your writing.
+The callout heading is provided by the callout type, with the expected heading (i.e., Note, Warning, Important, Tip, or Caution).
 :::
 
 ::: callout-tip
 ## Tip With Title
 
-This is an example of a callout with a title.
+This is an example of a callout with a title. Providing a callout heading is optional.
 :::
 
 ::: {.callout-caution collapse="true"}
-## Expand To Learn About Collapse
+## Caution: Expand To Learn About Collapse
 
 This is an example of a 'collapsed' caution callout that can be expanded by the user. You can use `collapse="true"` to collapse it by default or `collapse="false"` to make a collapsible callout that is expanded by default.
 :::