2005-07-21 09:37:28 +08:00
|
|
|
Django is a high-level Python Web framework that encourages rapid development
|
2012-04-28 11:25:08 +08:00
|
|
|
and clean, pragmatic design. Thanks for checking it out.
|
2005-07-21 09:37:28 +08:00
|
|
|
|
2005-07-21 23:06:49 +08:00
|
|
|
All documentation is in the "docs" directory and online at
|
2008-09-03 00:42:13 +08:00
|
|
|
http://docs.djangoproject.com/en/dev/. If you're just getting started, here's
|
|
|
|
how we recommend you read the docs:
|
2005-07-21 23:06:49 +08:00
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* First, read docs/intro/install.txt for instructions on installing Django.
|
2005-07-21 23:06:49 +08:00
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* Next, work through the tutorials in order (docs/intro/tutorial01.txt,
|
|
|
|
docs/intro/tutorial02.txt, etc.).
|
2005-07-21 23:06:49 +08:00
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* If you want to set up an actual deployment server, read
|
|
|
|
docs/howto/deployment/index.txt for instructions.
|
2005-07-21 22:11:25 +08:00
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* You'll probably want to read through the topical guides (in docs/topics)
|
|
|
|
next; from there you can jump to the HOWTOs (in docs/howto) for specific
|
|
|
|
problems, and check out the reference (docs/ref) for gory details.
|
2005-07-21 22:11:25 +08:00
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* See docs/README for instructions on building an HTML version of the docs.
|
2010-11-07 01:44:26 +08:00
|
|
|
|
2005-07-21 22:11:25 +08:00
|
|
|
Docs are updated rigorously. If you find any problems in the docs, or think they
|
|
|
|
should be clarified in any way, please take 30 seconds to fill out a ticket
|
|
|
|
here:
|
2005-07-21 09:37:28 +08:00
|
|
|
|
2011-01-29 06:07:43 +08:00
|
|
|
http://code.djangoproject.com/newticket
|
2005-07-21 09:37:28 +08:00
|
|
|
|
2005-07-21 22:11:25 +08:00
|
|
|
To get more help:
|
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* Join the #django channel on irc.freenode.net. Lots of helpful people hang out
|
|
|
|
there. Read the archives at http://django-irc-logs.com/.
|
2005-07-21 23:06:49 +08:00
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* Join the django-users mailing list, or read the archives, at
|
|
|
|
http://groups.google.com/group/django-users.
|
2005-07-21 23:06:49 +08:00
|
|
|
|
2005-07-21 22:11:25 +08:00
|
|
|
To contribute to Django:
|
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* Check out http://www.djangoproject.com/community/ for information about
|
|
|
|
getting involved.
|
2011-01-27 11:14:49 +08:00
|
|
|
|
|
|
|
To run Django's test suite:
|
|
|
|
|
2012-04-29 04:20:39 +08:00
|
|
|
* Follow the instructions in the "Unit tests" section of
|
|
|
|
docs/internals/contributing/writing-code/unit-tests.txt, published online at
|
|
|
|
https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/unit-tests/#running-the-unit-tests
|