diff --git a/docs/releasenotes.rst b/docs/releasenotes.rst
index f7b054a16faa73fd19259fbdc653f83284866bdf..e31d9566b7ecefe1c0170bf18148387b9a9410c1 100644
--- a/docs/releasenotes.rst
+++ b/docs/releasenotes.rst
@@ -2,6 +2,16 @@ Release notes
 =============
 
 
+x.y.z
+-----
+
+* ``common`` role
+
+  * Fixed permission errors with Python cache directories in the pip
+    requirements upgrade checks virtual environment that can happen if
+    the initial virtual environment set-up fails.
+
+
 8.0.0
 -----