diff --git a/CHANGELOG.md b/CHANGELOG.md
index e5c55448..69d60949 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [5.2.0] - Unreleased
+## [5.2.0] - 2020-08-13
 
 - Added crop argument to Console.print
 - Added "ignore" overflow method
diff --git a/docs/source/introduction.rst b/docs/source/introduction.rst
index 3eff4842..3d47f78f 100644
--- a/docs/source/introduction.rst
+++ b/docs/source/introduction.rst
@@ -14,6 +14,9 @@ On Windows both the (ancient) cmd.exe terminal is supported and the new `Windows
 
 Rich requires Python 3.6.1 and above. Note that Python 3.6.0 is *not* supported due to lack of support for methods on NamedTuples.
 
+.. note::
+    PyCharm users will need to enable "emulate terminal" in output console option in run/debug configuration to see styled output.
+
 Installation
 ------------
 
@@ -69,7 +72,7 @@ Continue reading to learn about the more advanced features of Rich.
 Python in the REPL
 ------------------
 
-Rich may be installed in the REPL so that Python data structures are pretty printed with syntax highlighting. Here's how::
+Rich may be installed in the REPL so that Python data structures are automatically pretty printed with syntax highlighting. Here's how::
 
     >>> from rich import pretty
     >>> pretty.install()