diff --git a/news/2317.doc.rst b/news/2317.doc.rst
new file mode 100644
index 00000000..ff56fe4d
--- /dev/null
+++ b/news/2317.doc.rst
@@ -0,0 +1 @@
+Added documenation about variable expansion in ``Pipfile`` entries.