From 78dd05adb582180b1ff9ce6aefeae2b37a09fdae Mon Sep 17 00:00:00 2001
From: Stuart Bishop <stuart@stuartbishop.net>
Date: Wed, 29 Mar 2023 15:10:10 +1100
Subject: [PATCH] Update README for 2023

Closes #101
---
 src/README.rst | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/src/README.rst b/src/README.rst
index dc5650e..1af9169 100644
--- a/src/README.rst
+++ b/src/README.rst
@@ -14,6 +14,14 @@ Library Reference (``datetime.tzinfo``).
 
 Almost all of the Olson timezones are supported.
 
+.. note::
+
+    Projects using Python 3.9 or later should be using the support
+    now included as part of the standard library, and third party
+    packages work with it such as `tzdata <https://pypi.org/project/tzdata/>`_.
+    pytz offers no advantages beyond backwards compatibility with
+    code written for earlier versions of Python.
+
 .. note::
 
     This library differs from the documented Python API for
@@ -543,12 +551,10 @@ Latest Versions
 This package will be updated after releases of the Olson timezone
 database.  The latest version can be downloaded from the `Python Package
 Index <https://pypi.org/project/pytz/>`_.  The code that is used
-to generate this distribution is hosted on launchpad.net and available
+to generate this distribution is hosted on Github and available
 using git::
 
-    git clone https://git.launchpad.net/pytz
-
-A mirror on github is also available at https://github.com/stub42/pytz
+    git clone https://github.com/stub42/pytz.git
 
 Announcements of new releases are made on
 `Launchpad <https://launchpad.net/pytz>`_, and the
@@ -559,7 +565,9 @@ hosted there.
 Bugs, Feature Requests & Patches
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Bugs can be reported using `Launchpad Bugs <https://bugs.launchpad.net/pytz>`_.
+Bugs should be reported on `Github <https://github.com/stub42/pytz/issues>`_.
+Feature requests are unlikely to be considered, and efforts instead directed
+to timezone support now built into Python or packages that work with it.
 
 
 Security Issues
@@ -571,9 +579,13 @@ Reports about security issues can be made via `Tidelift <https://tidelift.com/se
 Issues & Limitations
 ~~~~~~~~~~~~~~~~~~~~
 
+- This project is in maintenance mode. Projects using Python 3.9 or later
+  are best served by using the timezone functionaly now included in core
+  Python and packages that work with it such as `tzdata <https://pypi.org/project/tzdata/>`_.
+
 - Offsets from UTC are rounded to the nearest whole minute, so timezones
   such as Europe/Amsterdam pre 1937 will be up to 30 seconds out. This
-  is a limitation of the Python datetime library.
+  was a limitation of the Python datetime library.
 
 - If you think a timezone definition is incorrect, I probably can't fix
   it. pytz is a direct translation of the Olson timezone database, and
@@ -594,4 +606,3 @@ Contact
 
 Stuart Bishop <stuart@stuartbishop.net>
 
-