Merge pull request #133 from AusDTO/feature/improve-callouts-doco

Feature/improve callouts doco Thanks @klepas :) Will just need your help with the template for UI-Kit.

_patterns/callouts/callout-guidance.md

@@ -1,8 +1,8 @@
 {% assign ID = "callouts" %}
 
 {% capture content %}
-- You can use these classes on paragraphs or a wrapping element, like an `<aside>` or a `<div>`.
-- Use the `.callout--calendar` to highlight an important date, but use the [Calendar table pattern](/patterns/calendar-table) for a table of dates.
+- You can use callout classes on paragraphs or a wrapping element, for example `<aside>` or `<div>`.
+- Use the `.callout--calendar` to highlight an important date. For more than 1 date use the [calendar table pattern](/patterns/calendar-table).
 {% endcapture %}
 
 {% include guidance.liquid  content = content  ID = ID %}

_patterns/callouts/index.md

@@ -3,12 +3,11 @@ layout: collections/item
 title: Callouts
 section: Callouts
 sections:
-  - headline: Callouts
   - code:
     - scss: assets/sass/components/_typogaphy
     - markup: callouts-examples
   - md: Callout guidance
 ---
 
-Use callouts to notify and alert users of important snippets of information.
+Use callouts to give important information where the user needs it.
 {: .abstract }