diff --git a/docs/specifiers.md b/docs/specifiers.md
index dc5cd5df..c16280eb 100644
--- a/docs/specifiers.md
+++ b/docs/specifiers.md
@@ -6,12 +6,18 @@
 You can specify versions of a package using the [Semantic Versioning scheme](https://semver.org/)
 (i.e. `major.minor.micro`).
 
-For example, to install requests you can use:
+To install a major version of requests you can use:
 
     $ pipenv install requests~=1.1
 
 Pipenv will install version `1.2` as it is a minor update, but not `2.0`.
 
+To install a minor version of requests you can use:
+
+    $ pipenv install requests~=1.0.1
+
+Pipenv will install version `1.0.4` as it is a micro version update, but not `1.1.0`.
+
 This will update your `Pipfile` to reflect this requirement, automatically.
 
 In general, Pipenv uses the same specifier format as pip. However, note that according to [PEP 440](https://www.python.org/dev/peps/pep-0440/),
@@ -45,11 +51,11 @@ on your `PATH`), use the `--python VERSION` flag, like so:
 
 Use Python 3
 
-   $ pipenv --python 3
+    $ pipenv --python 3
 
 Use Python3.11
 
-   $ pipenv --python 3.11
+    $ pipenv --python 3.11
 
 
 When given a Python version, like this, Pipenv will automatically scan your system for a Python that matches that given version.
diff --git a/news/5594.docs.rst b/news/5594.doc.rst
similarity index 98%
rename from news/5594.docs.rst
rename to news/5594.doc.rst
index 0aba86c6..f9971075 100644
--- a/news/5594.docs.rst
+++ b/news/5594.doc.rst
@@ -1 +1 @@
-Made documentation clear about tilde-equals operator for package versions.
+Made documentation clear about tilde-equals operator for package versions.