From 669f44306c0c51fee3c45582f1f936bfdc609a2c Mon Sep 17 00:00:00 2001
From: a <a@trwnh.com>
Date: Fri, 5 Jun 2026 18:40:02 -0500
Subject: [PATCH] Fix: time offsets vs time zones uses better wording

Fix https://github.com/w3c/activitystreams/issues/701
---
 core/index.html | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/core/index.html b/core/index.html
index 0249f57..d3356a5 100644
--- a/core/index.html
+++ b/core/index.html
@@ -425,18 +425,19 @@ <h3>Date and Times</h3>
           "time-offset" and "full-date" constructs are as defined in
           [[RFC3339]].
         </p>
-<pre>
+<pre class="abnf">
 as2-partial-time = time-hour ":" time-minute [":" time-second [time-secfrac]]
 as2-full-time    = as2-partial-time time-offset
 as2-date-time    = full-date "T" as2-full-time
 </pre>
 
-        <p>
-          It is important to note that the `time-offset` component does not
-          correlate to time-zones, and while times that include the
-          `time-offset` component work well for timestamps, they cannot be
-          reliably converted to and from local "wall times" without additional
-          information and processing.
+        <p class="note" title="Avoiding common confusion between time offsets and time zones">
+          The `time-offset` component correlates to a time offset from UTC, which is
+          not the same as a "time zone". Applications cannot reliably convert
+          time offsets to time zones without additional information and processing,
+          such as knowing when daylight saving rules are in effect for certain localities,
+          as well as the history of legislation which affects historical start and end times
+          for daylight saving rules.
         </p>
 
       </section>
@@ -2523,6 +2524,18 @@ <h2>Example using Multiple Vocabularies</h2>
 
     <h2>Changelog</h2>
 
+    <section>
+      <h3>Changes since 2017-05-23 Recommendation</h3>
+      <p>The following changes have been made to this document since the
+      previous recommendation of <a href="https://www.w3.org/TR/2017/REC-activitystreams-core-20170523/">2017-05-23</a>:</p>
+      <ul>
+        <li>Cleaned up language around datetime serialization.</li>
+      </ul>
+    </section>
+    
+    <section>
+      <h3>Changes since 2016-12-15 Candidate Recommendation</h3>
+    </section>
     <p>
       The following notable changes have been made to this document since the
       previous candidate recommendation of <a href="https://www.w3.org/TR/2016/CR-activitystreams-core-20161215/#changelog">2016-12-15</a>.