Browse Source

Fixed #30816 -- Doc'd how to create projects with a local copy of Django.

Ad Timmering 5 years ago
parent
commit
dee687e93a
1 changed files with 15 additions and 3 deletions
  1. 15 3
      docs/intro/contributing.txt

+ 15 - 3
docs/intro/contributing.txt

@@ -177,15 +177,27 @@ command line to help you keep track of which one you are using. Anything you
 install through ``pip`` while this name is displayed will be installed in that
 virtual environment, isolated from other environments and system-wide packages.
 
+.. _intro-contributing-install-local-copy:
+
 Go ahead and install the previously cloned copy of Django:
 
 .. console::
 
     $ python -m pip install -e /path/to/your/local/clone/django/
 
-The installed version of Django is now pointing at your local copy. You will
-immediately see any changes you make to it, which is of great help when writing
-your first patch.
+The installed version of Django is now pointing at your local copy by installing
+in editable mode. You will immediately see any changes you make to it, which is
+of great help when writing your first patch.
+
+Creating projects with a local copy of Django
+---------------------------------------------
+
+It may be helpful to test your local changes with a Django project. First you
+have to create a new virtual environment, :ref:`install the previously cloned
+local copy of Django in editable mode <intro-contributing-install-local-copy>`,
+and create a new Django project outside of your local copy of Django. You will
+immediately see any changes you make to Django in your new project, which is
+of great help when writing your first patch.
 
 Running Django's test suite for the first time
 ==============================================