3 files changed, 37 insertions, 9 deletions
diff --git a/exampleSite/config.yml b/exampleSite/config.yml
index 49faaee..7dc5972 100644
--- a/exampleSite/config.yml
+++ b/exampleSite/config.yml
@@ -161,17 +161,44 @@ params:
   #
   # dateFormat Default: "January 2, 2006 at 3:04 PM"
   # shortDateFormat Default: "15:04 — Jan 2"
-  dateFormat: January 2, 2006 at 3:04 PM
-  shortDateFormat: 15:04 — Jan 2
+  dateFormat: January 2, 2006 at 3:04 PM UTC
+  shortDateFormat: 15:04 UTC — Jan 2
 
-  # If enabled, will display relative times for incident history and summaries instead of using dateFormat.
+  # Should relative time (x min ago) be used?
+  #
+  # IMPORTANT: In the frontmatter, the dates MUST be in
+  # the UTC time zone for this to work preperly. If you 
+  # use Netlify CMS, all good — the CMS picks UTC time
+  # by default. Otherwise, there may be very inaccurate
+  # times if multiple time zones are in your issue files.
+  #
+  # FOR YOUR CONSIDERATION: This feature was introduced in
+  # v5. It may be a breaking change in the case when you
+  # wish to use relative time but old issues do not have
+  # UTC time (and therefore are out of sync by ±24 hours)
+  #
+  # Read the wiki for more: 
+  # https://github.com/cstate/cstate/wiki/Customization#time 
+  #
+  # If enabled, will display relative times in places like
+  # the incident history and summaries instead of using
+  # dateFormat and shortDateFormat (except for if you use
+  # the old shortcode).
   #
   # Default: `true`
+  # BOOLEAN; `true`, `false`
   useRelativeTime: true
-
+ 
   # If enabled, doesn't show seconds on relative times.
   #
+  # With option ON (true):
+  # "Last checked <1 min ago"
+  #
+  # With option OFF (false; default):
+  # "Last checked 20s ago"
+  #
   # Default: `false`
+  # BOOLEAN; `true`, `false`
   skipSeconds: false
 
   # What header design should we use?
diff --git a/exampleSite/content/issues/2019-10-08-testing-new-pipeline.md b/exampleSite/content/issues/2019-10-08-testing-new-pipeline.md
index 4f139de..4e9da4f 100644
--- a/exampleSite/content/issues/2019-10-08-testing-new-pipeline.md
+++ b/exampleSite/content/issues/2019-10-08-testing-new-pipeline.md
@@ -1,7 +1,7 @@
 ---
 title: New Pipeline Rollout
 date: 2019-10-05 16:24:00 
-resolved: false
+resolved: true
 resolvedWhen: 2019-10-05 16:58:00 
 # Possible severity levels: down, disrupted, notice
 severity: disrupted
diff --git a/exampleSite/content/issues/2020-06-13-maintenance-window.md b/exampleSite/content/issues/2021-02-13-maintenance-window.md
index 404ccc4..00b4765 100644
--- a/exampleSite/content/issues/2020-06-13-maintenance-window.md
+++ b/exampleSite/content/issues/2021-02-13-maintenance-window.md
@@ -1,8 +1,9 @@
 ---
 title: Maintenance Window
-date: 2020-06-13 15:54:00
-resolved: true
-resolvedWhen: 2020-06-13 16:54:00
+#date: 24 Feb 21 12:35 +0200
+date: 2021-02-24 10:35:00
+resolved: false
+resolvedWhen: 2021-02-24 12:10:00
 # Possible severity levels: down, disrupted, notice
 severity: disrupted
 affected:
@@ -10,4 +11,4 @@ affected:
 section: issue
 ---
 
-*Just began* - We're currently shutting down the network. {{< track "2018-06-13 15:54:00" >}}
+*Just began* - We're currently shutting down the network. {{< track "2018-06-13 12:54:00" >}}