1 files changed, 193 insertions, 0 deletions
diff --git a/docs/users_guide/8.2.1-notes.rst b/docs/users_guide/8.2.1-notes.rst
new file mode 100644
index 0000000000..957552b302
--- /dev/null
+++ b/docs/users_guide/8.2.1-notes.rst
@@ -0,0 +1,193 @@
+.. _release-8-2-1:
+
+Release notes for version 8.2.1
+===============================
+
+The significant changes to the various parts of the compiler are listed
+in the following sections. There have also been numerous bug fixes and
+performance improvements over the 8.0 branch.
+
+Highlights
+----------
+
+The highlights since the 8.0 branch are:
+
+- TODO FIXME
+
+Full details
+------------
+
+Language
+~~~~~~~~
+
+-  TODO FIXME.
+
+Compiler
+~~~~~~~~
+
+-  TODO FIXME.
+
+GHCi
+~~~~
+
+-  TODO FIXME.
+
+Template Haskell
+~~~~~~~~~~~~~~~~
+
+-  TODO FIXME.
+
+Runtime system
+~~~~~~~~~~~~~~
+
+-  TODO FIXME.
+
+Build system
+~~~~~~~~~~~~
+
+-  TODO FIXME.
+
+Package system
+~~~~~~~~~~~~~~
+
+-  TODO FIXME.
+
+hsc2hs
+~~~~~~
+
+-  TODO FIXME.
+
+Libraries
+---------
+
+array
+~~~~~
+
+-  Version number XXXXX (was 0.5.0.0)
+
+
+.. _lib-base:
+
+base
+~~~~
+
+See ``changelog.md`` in the ``base`` package for full release notes.
+
+-  Version number 4.10.0.0 (was 4.9.0.0)
+
+binary
+~~~~~~
+
+-  Version number XXXXX (was 0.7.1.0)
+
+bytestring
+~~~~~~~~~~
+
+-  Version number XXXXX (was 0.10.4.0)
+
+Cabal
+~~~~~
+
+-  Version number XXXXX (was 1.18.1.3)
+
+containers
+~~~~~~~~~~
+
+-  Version number XXXXX (was 0.5.4.0)
+
+deepseq
+~~~~~~~
+
+-  Version number XXXXX (was 1.3.0.2)
+
+directory
+~~~~~~~~~
+
+-  Version number XXXXX (was 1.2.0.2)
+
+filepath
+~~~~~~~~
+
+-  Version number XXXXX (was 1.3.0.2)
+
+ghc
+~~~
+
+-  TODO FIXME.
+
+ghc-boot
+~~~~~~~~
+
+-  This is an internal package. Use with caution.
+
+-  TODO FIXME.
+
+ghc-prim
+~~~~~~~~
+
+-  Version number XXXXX (was 0.3.1.0)
+
+haskell98
+~~~~~~~~~
+
+-  Version number XXXXX (was 2.0.0.3)
+
+haskell2010
+~~~~~~~~~~~
+
+-  Version number XXXXX (was 1.1.1.1)
+
+hoopl
+~~~~~
+
+-  Version number XXXXX (was 3.10.0.0)
+
+hpc
+~~~
+
+-  Version number XXXXX (was 0.6.0.1)
+
+integer-gmp
+~~~~~~~~~~~
+
+-  Version number XXXXX (was 0.5.1.0)
+
+old-locale
+~~~~~~~~~~
+
+-  Version number XXXXX (was 1.0.0.6)
+
+old-time
+~~~~~~~~
+
+-  Version number XXXXX (was 1.1.0.2)
+
+process
+~~~~~~~
+
+-  Version number XXXXX (was 1.2.0.0)
+
+template-haskell
+~~~~~~~~~~~~~~~~
+
+-  Version number XXXXX (was 2.9.0.0)
+
+time
+~~~~
+
+-  Version number XXXXX (was 1.4.1)
+
+unix
+~~~~
+
+-  Version number XXXXX (was 2.7.0.0)
+
+Win32
+~~~~~
+
+-  Version number XXXXX (was 2.3.0.1)
+
+Known bugs
+----------
+
+-  TODO FIXME