diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 07f396083a..286fd10570 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -29,6 +29,7 @@ Changelog
  * Added validation on the filter string to the Jinja2 image template tag (Jonny Scholes)
  * Changed the pages reodering UI toggle to make it easier to find (Katie Locke, Thibaud Colas)
  * Added support for rich text link rewrite handlers for `external` and `email` links (Md Arifin Ibne Matin)
+ * Clarify installation instructions in documentation, especially regarding virtual environments. (Naomi Morduch Toubman)
  * Fix: Set `SERVER_PORT` to 443 in `Page.dummy_request()` for HTTPS sites (Sergey Fedoseev)
  * Fix: Include port number in `Host` header of `Page.dummy_request()` (Sergey Fedoseev)
  * Fix: Validation error messages in `InlinePanel` no longer count towards `max_num` when disabling the 'add' button (Todd Dembrey, Thibaud Colas)
diff --git a/docs/releases/2.5.rst b/docs/releases/2.5.rst
index dfdab5d11c..ea3bbb1927 100644
--- a/docs/releases/2.5.rst
+++ b/docs/releases/2.5.rst
@@ -55,6 +55,7 @@ Other features
  * Added validation on the filter string to the Jinja2 image template tag (Jonny Scholes)
  * Changed the pages reodering UI toggle to make it easier to find (Katie Locke, Thibaud Colas)
  * Added support for rich text link rewrite handlers for ``external`` and ``email`` links (Md Arifin Ibne Matin)
+ * Clarify installation instructions in documentation, especially regarding virtual environments. (Naomi Morduch Toubman)
 
 
 Bug fixes