innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

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

Backport of dee687e93a from master
This commit is contained in:
Ad Timmering 2019-10-12 11:44:37 +09:00 committed by Mariusz Felisiak
parent 9adb80efee
commit 18631226da
1 changed files with 15 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/intro/contributing.txt
View File

@ -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
==============================================