diff --git a/README.md b/README.md
index 0685f94..13ce354 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# cx_Oracle version 8.2 (Development)
+# cx_Oracle version 8.2
 
 cx_Oracle is a Python extension module that enables access to Oracle
 Database.  It conforms to the [Python database API 2.0
@@ -7,7 +7,7 @@ of exclusions.  See the
 [homepage](https://oracle.github.io/python-cx_Oracle/index.html) for a
 feature list.
 
-cx_Oracle 8 has been tested with Python versions 3.6 through 3.9. You can use
+cx_Oracle 8.2 has been tested with Python versions 3.6 through 3.9. You can use
 cx_Oracle with Oracle 11.2, 12c, 18c, 19c and 21c client libraries. Oracle's
 standard client-server version interoperability allows connection to both older
 and newer databases. For example Oracle 19c client libraries can connect to
diff --git a/doc/src/conf.py b/doc/src/conf.py
index dc8e6d2..4b1d6b9 100644
--- a/doc/src/conf.py
+++ b/doc/src/conf.py
@@ -42,7 +42,7 @@
 # The short X.Y version.
 version = '8.2'
 # The full version, including alpha/beta/rc tags.
-release = '8.2.0-dev'
+release = '8.2.0'
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
diff --git a/doc/src/release_notes.rst b/doc/src/release_notes.rst
index 11037ac..72891fd 100644
--- a/doc/src/release_notes.rst
+++ b/doc/src/release_notes.rst
@@ -7,12 +7,12 @@ cx_Oracle Release Notes
 
 For any deprecations, see :ref:`Deprecations <deprecations>`.
 
-Version 8.2 (TBD)
------------------
+Version 8.2 (May 2021)
+----------------------
 
 #)  Updated embedded ODPI-C to `version 4.2.0
     <https://oracle.github.io/odpi/doc/releasenotes.html#
-    version-4-2-tbd>`__.
+    version-4-2-may-18-2021>`__.
 #)  Threaded mode is now always enabled when creating connection pools with
     :meth:`cx_Oracle.SessionPool()`. Any `threaded` parameter value is ignored.
 #)  Added :meth:`SessionPool.reconfigure()` to support pool reconfiguration.
@@ -24,7 +24,7 @@ Version 8.2 (TBD)
     pool.  In addition, the attribute
     :data:`SessionPool.max_sessions_per_shard` was added in order to permit
     making adjustments after the pool has been created. They are usable when
-    using Oracle Client version 18.4 and higher.
+    using Oracle Client version 18.3 and higher.
 #)  Added parameter `stmtcachesize` to :meth:`cx_Oracle.connect()` and
     :meth:`cx_Oracle.SessionPool()` in order to permit specifying the size of
     the statement cache during the creation of pools and standalone
@@ -41,7 +41,8 @@ Version 8.2 (TBD)
     significantly improves the performance of methods
     :meth:`SodaDatabase.createCollection()` (when not specifying a value for
     the metadata parameter) and :meth:`SodaDatabase.openCollection()`. Caching
-    is available when using Oracle Client version 19.11 and higher.
+    is available when using Oracle Client version 21.3 and higher (or Oracle
+    Client 19 from 19.11).
 #)  Added support for supplying hints to SODA operations. A new non-terminal
     method :meth:`~SodaOperation.hint()` was added and a `hint` parameter was
     added to the methods :meth:`SodaCollection.insertOneAndGet()`,
diff --git a/setup.py b/setup.py
index daa43ad..53c5afc 100644
--- a/setup.py
+++ b/setup.py
@@ -16,7 +16,7 @@
 pkg_resources.require("setuptools>=40.6.0")
 
 # define build constants
-BUILD_VERSION = "8.2.0-dev"
+BUILD_VERSION = "8.2.0"
 
 # setup extra link and compile args
 extra_link_args = []