>From a08dea1d9b78d05e13ffbe2896bae4e443bb017d Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@cs.ucla.edu>
Date: Sun, 24 Apr 2016 12:19:31 -0700
Subject: [PROPOSED PATCH] * NEWS, tz-link.htm: Cite Matt Johnson on change
 notice.

---
 NEWS        |  5 +++++
 tz-link.htm | 63 ++++++++++++++++++++++++++++++++++++++++---------------------
 2 files changed, 46 insertions(+), 22 deletions(-)

diff --git a/NEWS b/NEWS
index 17c5934..04fac5e 100644
--- a/NEWS
+++ b/NEWS
@@ -7,6 +7,11 @@ Unreleased, experimental changes
     Asia/Baku's 1992-09-27 transition from +04 (DST) to +04 (non-DST) was
     at 03:00, not 23:00 the previous day.  (Thanks to Michael Deckers.)
 
+  Changes affecting documentation and commentary
+
+    tz-link.htm says why governments should give plenty of notice for
+    time zone or DST changes, and refers to Matt Johnson's blog post.
+
 
 Release 2016d - 2016-04-17 22:50:29 -0700
 
diff --git a/tz-link.htm b/tz-link.htm
index feede12..80f40bd 100644
--- a/tz-link.htm
+++ b/tz-link.htm
@@ -10,7 +10,7 @@
  content="Sources for time zone and daylight saving time data">
 <meta name="DC.Creator" content="Eggert, Paul">
 <meta name="DC.Contributor" content="Olson, Arthur David">
-<meta name="DC.Date" content="2016-02-29">
+<meta name="DC.Date" content="2016-04-24">
 <meta name="DC.Description"
  content="Sources of information about time zones and daylight saving time">
 <meta name="DC.Identifier"
@@ -20,6 +20,13 @@
 </head>
 <body>
 <h1>Sources for time zone and daylight saving time data</h1>
+<p>
+Time zone and daylight saving rules are controlled by individual
+governments. They are sometimes changed with little notice, and their
+histories and planned futures are often recorded only fitfully. Here
+is a summary of attempts to organize and record relevant data in this
+area.
+</p>
 <h2>The <code><abbr title="time zone">tz</abbr></code> database</h2>
 <p>
 The <a href="https://en.wikipedia.org/wiki/Public_domain">public-domain</a>
@@ -140,8 +147,10 @@ The code lets you compile the <code><abbr>tz</abbr></code> source files into
 machine-readable binary files, one for each location. It also lets
 you read a <code><abbr>tz</abbr></code> binary file and interpret time stamps for that
 location.</p>
+<h2>Changes to the <code><abbr>tz</abbr></code> database</h2>
 <p>
-The files are by no means authoritative. If you find errors, please
+The <code><abbr>tz</abbr></code> code and data
+are by no means authoritative. If you find errors, please
 send changes to the <a href="mailto:tz@iana.org">time zone
 mailing list</a>. You can also <a
 href="http://news.gmane.org/gmane.comp.time.tz">browse recent
@@ -149,28 +158,15 @@ messages</a> sent to the mailing list, <a
 href="https://mm.icann.org/mailman/listinfo/tz">subscribe</a> to it,
 and browse the <a
 href="http://mm.icann.org/pipermail/tz/">archive of old
-messages</a>. For further information about updates, please see
-<a href="http://tools.ietf.org/html/rfc6557">Procedures for
-Maintaining the Time Zone Database</a> (Internet <abbr
-title="Request For Comments">RFC</abbr> 6557).</p>
+messages</a>.</p>
 <p>
-The Web has several other sources for time zone and daylight saving time data.
-Here are some links that may be of interest.
+If your government plans to change its time zone boundaries or
+daylight saving rules, let the mailing list know well in advance. With
+less than a year's notice there is a good chance that some
+computer-based clocks will operate incorrectly after the change, due
+to delays in propagating updates to software and data. The shorter
+the notice, the more likely clock problems will arise.
 </p>
-<h2>Commentary on the <code><abbr>tz</abbr></code> database</h2>
-<ul>
-<li>The article
-<a href="https://en.wikipedia.org/wiki/Tz_database">tz database</a> is
-an encyclopedic summary.</li>
-<li><a href="tz-how-to.html">How to Read the
-tz Database Source Files</a> explains the <code><abbr>tz</abbr></code>
-database format.</li>
-<li><a
-href="http://blog.jonudell.net/2009/10/23/a-literary-appreciation-of-the-olsonzoneinfotz-database/">A
-literary appreciation of the Olson/Zoneinfo/tz database</a> comments on the
-database's style.</li>
-</ul>
-<h2>Editing <code><abbr>tz</abbr></code> database source files</h2>
 <p>Sources for the <code><abbr>tz</abbr></code> database are
 <a href="https://en.wikipedia.org/wiki/UTF-8"><abbr
 title="Unicode Transformation Format 8-bit">UTF-8</abbr></a>
@@ -188,6 +184,29 @@ zoneinfo</a> is a <a href="http://www.sublimetext.com/">Sublime
 Text</a> package for syntax highlighting <code><abbr>tz</abbr></code>
 source files.</li>
 </ul>
+<p>
+For further information about updates, please see
+<a href="http://tools.ietf.org/html/rfc6557">Procedures for
+Maintaining the Time Zone Database</a> (Internet <abbr
+title="Request For Comments">RFC</abbr> 6557).</p>
+<h2>Commentary on the <code><abbr>tz</abbr></code> database</h2>
+<ul>
+<li>The article
+<a href="https://en.wikipedia.org/wiki/Tz_database">tz database</a> is
+an encyclopedic summary.</li>
+<li><a href="tz-how-to.html">How to Read the
+tz Database Source Files</a> explains the <code><abbr>tz</abbr></code>
+database format.</li>
+<li><a
+href="http://codeofmatt.com/2016/04/23/on-the-timing-of-time-zone-changes/">On
+the Timing of Time Zone Changes</a> gives examples of problems caused
+by inadequate notice by governments of time zone and daylight saving
+rule changes.</li>
+<li><a
+href="http://blog.jonudell.net/2009/10/23/a-literary-appreciation-of-the-olsonzoneinfotz-database/">A
+literary appreciation of the Olson/Zoneinfo/tz database</a> comments on the
+database's style.</li>
+</ul>
 <h2>Web sites using recent versions of the <code><abbr>tz</abbr></code> database</h2>
 <p>
 These are listed roughly in ascending order of complexity and fanciness.
-- 
2.7.4

