diff --git a/docs/specifiers.md b/docs/specifiers.md
index 758dc72c..dc5cd5df 100644
--- a/docs/specifiers.md
+++ b/docs/specifiers.md
@@ -8,9 +8,9 @@ You can specify versions of a package using the [Semantic Versioning scheme](htt
 
 For example, to install requests you can use:
 
-    $ pipenv install requests~=1.2
+    $ pipenv install requests~=1.1
 
-Pipenv will install version `1.2` and any minor update, but not `2.0`.
+Pipenv will install version `1.2` as it is a minor update, but not `2.0`.
 
 This will update your `Pipfile` to reflect this requirement, automatically.
 
diff --git a/news/5594.docs.rst b/news/5594.docs.rst
new file mode 100644
index 00000000..8318c21d
--- /dev/null
+++ b/news/5594.docs.rst
@@ -0,0 +1 @@
+Made documentation clear about tilde-equals operator for package versions.
\ No newline at end of file