From c1eee49b1e785dca4ee0748a9c10968c5f7d7ec7 Mon Sep 17 00:00:00 2001
From: Aniekan Akpan <aniekanbtc@gmail.com>
Date: Thu, 25 Jan 2024 22:24:08 +0100
Subject: [PATCH] Updated contributing.txt documentation for cross-platform
 compatibility and added clarification notes for Windows users

---
 docs/intro/contributing.txt | 47 ++++++++++++++++++++++++++++---------
 1 file changed, 36 insertions(+), 11 deletions(-)

diff --git a/docs/intro/contributing.txt b/docs/intro/contributing.txt
index 812656cbba..fb951f9f00 100644
--- a/docs/intro/contributing.txt
+++ b/docs/intro/contributing.txt
@@ -220,9 +220,15 @@ encounter.
 Now we are ready to run the test suite. If you're using GNU/Linux, macOS, or
 some other flavor of Unix, run:
 
-.. console::
+.. code-block:: console 
 
-    $ python ./runtests.py
+    $ ./runtests.py
+
+If you're using Windows, run:
+
+.. code-block:: doscon
+
+    ...\> python runtests.py
 
 Now sit back and relax. Django's entire test suite has thousands of tests, and
 it takes at least a few minutes to run, depending on the speed of your
@@ -357,11 +363,18 @@ Running your new test
 
 Since we haven't made any modifications to ``django.shortcuts`` yet, our test
 should fail. Let's run all the tests in the ``shortcuts`` folder to make sure
-that's really what happens. ``cd`` to the Django ``tests/`` directory and run:
+that's really what happens. ``cd`` to the Django ``tests/`` directory and if 
+you're using GNU/Linux, macOS, or some other flavor of Unix, run:
 
-.. console::
+.. code-block:: console
 
-    $ python ./runtests.py shortcuts
+    $ ./runtests.py shortcuts
+
+If you're using Windows, run:
+
+.. code-block:: doscon
+
+    ...\> python runtests.py shortcuts
 
 If the tests ran correctly, you should see one failure corresponding to the test
 method we added, with this error:
@@ -386,11 +399,17 @@ bottom, add::
 
 Now we need to make sure that the test we wrote earlier passes, so we can see
 whether the code we added is working correctly. Again, navigate to the Django
-``tests/`` directory and run:
+``tests/`` directory and if you're using GNU/Linux, macOS, or some other flavor of Unix, run:
 
-.. console::
+.. code-block:: console
 
-    $ python ./runtests.py shortcuts
+    $ ./runtests.py shortcuts
+
+If you're using Windows, run:
+
+.. code-block:: doscon
+
+    ...\> python runtests.py shortcuts
 
 Everything should pass. If it doesn't, make sure you correctly added the
 function to the correct file.
@@ -405,11 +424,17 @@ passing the entire test suite doesn't guarantee your code is bug free, it does
 help identify many bugs and regressions that might otherwise go unnoticed.
 
 To run the entire Django test suite, ``cd`` into the Django ``tests/``
-directory and run:
+directory and if you're using GNU/Linux, macOS, or some other flavor of Unix, run:
 
-.. console::
+.. code-block:: console
 
-    $ python ./runtests.py
+    $ ./runtests.py
+
+If you're using windows, run:
+
+.. code-block:: doscon
+
+    ...\> python runtests.py shortcuts
 
 Writing Documentation
 =====================