diff --git a/changelog.d/3144.doc.rst b/changelog.d/3144.doc.rst
new file mode 100644
index 0000000000..36cc652103
--- /dev/null
+++ b/changelog.d/3144.doc.rst
@@ -0,0 +1 @@
+Added documentation on using console_scripts from setup.py, which was previously only shown in setup.cfg  -- by :user:`xhlulu`
\ No newline at end of file
diff --git a/docs/userguide/entry_point.rst b/docs/userguide/entry_point.rst
index 21edc6971a..ea73bb5e0c 100644
--- a/docs/userguide/entry_point.rst
+++ b/docs/userguide/entry_point.rst
@@ -54,11 +54,32 @@ above example, to create a command ``hello-world`` that invokes
 ``timmins.hello_world``, add a console script entry point to
 ``setup.cfg``:
 
-.. code-block:: ini
+.. tab:: setup.cfg
+
+	.. code-block:: ini
+
+		[options.entry_points]
+		console_scripts =
+			hello-world = timmins:hello_world
+
+.. tab:: setup.py
+
+    .. code-block:: python
+	
+        from setuptools import setup
+
+        setup(
+            name='timmins',
+            version='0.0.1',
+            packages=['timmins'],
+			# ...
+            entry_points={
+				'console_scripts': [
+					'hello-world=timmins:hello_world',
+				]
+			}
+        )
 
-    [options.entry_points]
-    console_scripts =
-        hello-world = timmins:hello_world
 
 After installing the package, a user may invoke that function by simply calling
 ``hello-world`` on the command line.