Permalink
Browse files

Moved a note about django-admin.py errors from Tutorial Part 1 to a n…

…ew FAQ Troubleshooting page. This is to avoid confusion for beginners.
  • Loading branch information...
Agilemeister authored and jphalip committed Aug 4, 2012
1 parent 1978635 commit 5d4f993bb1f01c3a79194031827380dc763ce628
Showing with 20 additions and 9 deletions.
  1. +2 −1 docs/faq/index.txt
  2. +16 −0 docs/faq/troubleshooting.txt
  3. +2 −8 docs/intro/tutorial01.txt
View
@@ -11,4 +11,5 @@ Django FAQ
help
models
admin
- contributing
+ contributing
+ troubleshooting
@@ -0,0 +1,16 @@
+===============
+Troubleshooting
+===============
+
+This page contains some advice about errors and problems commonly encountered
+during the development of Django applications.
+
+"command not found: django-admin.py"
+------------------------------------
+
+:doc:`django-admin.py </ref/django-admin>` should be on your system path if you
+installed Django via ``python setup.py``. If it's not on your path, you can
+find it in ``site-packages/django/bin``, where ``site-packages`` is a directory
+within your Python installation. Consider symlinking to :doc:`django-admin.py
+</ref/django-admin>` from some place on your path, such as
+:file:`/usr/local/bin`.
View
@@ -52,7 +52,8 @@ code, then run the following command:
django-admin.py startproject mysite
-This will create a ``mysite`` directory in your current directory.
+This will create a ``mysite`` directory in your current directory. If it didn't
+work, see :doc:`Troubleshooting </faq/troubleshooting>`.
.. admonition:: Script name may differ in distribution packages
@@ -78,13 +79,6 @@ This will create a ``mysite`` directory in your current directory.
``django`` (which will conflict with Django itself) or ``test`` (which
conflicts with a built-in Python package).
-:doc:`django-admin.py </ref/django-admin>` should be on your system path if you
-installed Django via ``python setup.py``. If it's not on your path, you can find
-it in ``site-packages/django/bin``, where ``site-packages`` is a directory
-within your Python installation. Consider symlinking to :doc:`django-admin.py
-</ref/django-admin>` from some place on your path, such as
-:file:`/usr/local/bin`.
-
.. admonition:: Where should this code live?
If your background is in PHP, you're probably used to putting code under the

0 comments on commit 5d4f993

Please sign in to comment.