diff options
| author | Paul Eggert <eggert@cs.ucla.edu> | 2018-10-05 09:59:25 -0700 |
|---|---|---|
| committer | Paul Eggert <eggert@cs.ucla.edu> | 2018-10-05 09:59:25 -0700 |
| commit | 345c7cdc704b6cf2f9d257336b7f6519440180ce (patch) | |
| tree | 6c073a589d3df76c104595ddd064114ab85105a8 | |
| parent | 76d99df1e507d604adf77137240cc3a168464b20 (diff) | |
| download | tz-345c7cdc704b6cf2f9d257336b7f6519440180ce.tar.gz | |
Tweak CONTRIBUTING and README
Responding to a suggestion by Phake Nick in:
https://mm.icann.org/pipermail/tz/2018-October/026947.html
* CONTRIBUTING: Give a URL for theory.html, and ask people to read
theory.html if their contribution might be controversial.
* README: Reword slightly.
| -rw-r--r-- | CONTRIBUTING | 12 | ||||
| -rw-r--r-- | README | 16 |
2 files changed, 14 insertions, 14 deletions
diff --git a/CONTRIBUTING b/CONTRIBUTING index 0cfc77f..b334606 100644 --- a/CONTRIBUTING +++ b/CONTRIBUTING @@ -17,11 +17,13 @@ To email small changes, please run a POSIX shell command like 'diff -u old/europe new/europe >myfix.patch', and attach myfix.patch to the email. -For more-elaborate changes, please read the theory.html file and browse -the mailing list archives <https://mm.icann.org/pipermail/tz/> for -examples of patches that tend to work well. Additions to -data should contain commentary citing reliable sources as -justification. Citations should use https: URLs if available. +For more-elaborate or possibly-controversial changes, please read +<https://www.iana.org/time-zones/repository/theory.html> or the file +theory.html. It is also good to browse the mailing list archives +<https://mm.icann.org/pipermail/tz/> for examples of patches that tend +to work well. Additions to data should contain commentary citing +reliable sources as justification. Citations should use https: URLs +if available. Please submit changes against either the latest release in <https://www.iana.org/time-zones> or the master branch of the development @@ -4,7 +4,7 @@ README for the tz distribution "Any time you want it to be." -- Frank Baxter as The Scientist (from the Bell System film "About Time") -The Time Zone Database (often called tz or zoneinfo) contains code and +The Time Zone Database (called tz, tzdb or zoneinfo) contains code and data that represent the history of local time for many representative locations around the globe. It is updated periodically to reflect changes made by political bodies to time zone boundaries, UTC offsets, @@ -20,17 +20,15 @@ substituting your desired installation directory for "$HOME/tzdir": make TOPDIR=$HOME/tzdir install $HOME/tzdir/usr/bin/zdump -v America/Los_Angeles -Historical local time information has been included here to: +This database of historical local time information has several goals: -* provide a compendium of data about the history of civil time - that is useful even if not 100% accurate; + * Provide a compendium of data about the history of civil time that + is useful even if not 100% accurate. -* give an idea of the variety of local time rules that have - existed in the past and thus an idea of the variety that may be - expected in the future; + * Give an idea of the variety of local time rules that have existed + in the past and thus may be expected in the future. -* provide a test of the generality of the local time rule description - system. + * Test the generality of the local time rule description system. The information in the time zone data files is by no means authoritative; fixes and enhancements are welcome. Please see the file CONTRIBUTING |