summaryrefslogtreecommitdiff
path: root/docs/faq
diff options
context:
space:
mode:
authorOla Sitarska <ola@sitarska.com>2014-08-11 13:34:48 +0200
committerTim Graham <timograham@gmail.com>2014-08-12 13:46:10 -0400
commit549284faa4c58de420918ecd3120607db473787f (patch)
treed05d964d17b938ae66c4c45c6cd7370d213c1444 /docs/faq
parenta9fd740d22bc4fed5fdb280c036618000ee13df1 (diff)
Fixed #23016 -- Updated FAQs per Aymeric's suggestions.
Diffstat (limited to 'docs/faq')
-rw-r--r--docs/faq/admin.txt6
-rw-r--r--docs/faq/general.txt5
-rw-r--r--docs/faq/install.txt22
-rw-r--r--docs/faq/models.txt24
-rw-r--r--docs/faq/usage.txt2
5 files changed, 27 insertions, 32 deletions
diff --git a/docs/faq/admin.txt b/docs/faq/admin.txt
index dbcd725a8d..8deffdf28c 100644
--- a/docs/faq/admin.txt
+++ b/docs/faq/admin.txt
@@ -13,12 +13,6 @@ things:
"http://www.example.com/admin/" in your browser, in "myproject.settings" you
should set :setting:`SESSION_COOKIE_DOMAIN` = 'www.example.com'.
-* Some browsers (Firefox?) don't like to accept cookies from domains that
- don't have dots in them. If you're running the admin site on "localhost"
- or another domain that doesn't have a dot in it, try going to
- "localhost.localdomain" or "127.0.0.1". And set
- :setting:`SESSION_COOKIE_DOMAIN` accordingly.
-
I can't log in. When I enter a valid username and password, it brings up the login page again, with a "Please enter a correct username and password" error.
-----------------------------------------------------------------------------------------------------------------------------------------------------------
diff --git a/docs/faq/general.txt b/docs/faq/general.txt
index 610236fde9..a175e44325 100644
--- a/docs/faq/general.txt
+++ b/docs/faq/general.txt
@@ -46,8 +46,9 @@ We've also recorded an `audio clip of the pronunciation`_.
Is Django stable?
-----------------
-Yes, it's quite stable. World Online has been using Django for many years. Sites built on
-Django have weathered traffic spikes of over 50 thousand hits per second.
+Yes, it's quite stable. Companies like Disqus, Instagram, Pinterest, and
+Mozilla have been using Django for many years. Sites built on Django have
+weathered traffic spikes of over 50 thousand hits per second.
Does Django scale?
------------------
diff --git a/docs/faq/install.txt b/docs/faq/install.txt
index 2c129c954a..e83bc56f86 100644
--- a/docs/faq/install.txt
+++ b/docs/faq/install.txt
@@ -16,23 +16,22 @@ How do I get started?
What are Django's prerequisites?
--------------------------------
-Django requires Python, specifically Python 2.7 or 3.2 and above. No other
-Python libraries are required for basic Django usage.
+Django requires Python, specifically Python 2.7 or 3.2 and above. Other Python
+libraries may be required for some uses, but you'll receive an error about it
+as they're needed.
For a development environment -- if you just want to experiment with Django --
you don't need to have a separate Web server installed; Django comes with its
own lightweight development server. For a production environment, Django follows
the WSGI spec, :pep:`3333`, which means it can run on a variety of server
platforms. See :doc:`Deploying Django </howto/deployment/index>` for some
-popular alternatives. Also, the `server arrangements wiki page`_ contains
-details for several deployment strategies.
+popular alternatives.
If you want to use Django with a database, which is probably the case, you'll
also need a database engine. PostgreSQL_ is recommended, because we're
PostgreSQL fans, and MySQL_, `SQLite 3`_, and Oracle_ are also supported.
.. _Python: http://www.python.org/
-.. _server arrangements wiki page: https://code.djangoproject.com/wiki/ServerArrangements
.. _PostgreSQL: http://www.postgresql.org/
.. _MySQL: http://www.mysql.com/
.. _`SQLite 3`: http://www.sqlite.org/
@@ -47,12 +46,12 @@ Django version Python versions
1.4 2.5, 2.6, 2.7
1.5 2.6, 2.7 and 3.2, 3.3 (experimental)
1.6 2.6, 2.7 and 3.2, 3.3
-**1.7** **2.7** and **3.2, 3.3, 3.4**
+**1.7, 1.8** **2.7** and **3.2, 3.3, 3.4**
============== ===============
For a given series of Python versions, only the latest release is officially
-supported. For instance, at the time of writing (April 1st, 2014), the latest
-release in the 2.7 series is 2.7.6.
+supported. For instance, at the time of writing (August 1st, 2014), the latest
+release in the 2.7 series is 2.7.8.
What Python version should I use with Django?
---------------------------------------------
@@ -75,13 +74,6 @@ advantage of the improvements and optimizations in newer Python releases.
Third-party applications for use with Django are, of course, free to set their
own version requirements.
-Will Django run under shared hosting (like TextDrive or Dreamhost)?
--------------------------------------------------------------------
-
-See our `Django-friendly Web hosts`_ page.
-
-.. _`Django-friendly Web hosts`: https://code.djangoproject.com/wiki/DjangoFriendlyWebHosts
-
Should I use the stable version or development version?
-------------------------------------------------------
diff --git a/docs/faq/models.txt b/docs/faq/models.txt
index 57e3c8077f..efa9d34c9b 100644
--- a/docs/faq/models.txt
+++ b/docs/faq/models.txt
@@ -65,20 +65,28 @@ uniqueness at that level. Single-column primary keys are needed for things such
as the admin interface to work; e.g., you need a simple way of being able to
specify an object to edit or delete.
+Does Django support NoSQL databases?
+------------------------------------
+
+NoSQL databases are not officially supported by Django itself. There are,
+however, a number of side project and forks which allow NoSQL functionality in
+Django, like `Django non-rel`_.
+
+You can also take a look on `the wiki page`_ which discusses some alternatives.
+
+.. _`Django non-rel`: http://django-nonrel.org/
+.. _`the wiki page`: https://code.djangoproject.com/wiki/NoSqlSupport
+
How do I add database-specific options to my CREATE TABLE statements, such as specifying MyISAM as the table type?
------------------------------------------------------------------------------------------------------------------
We try to avoid adding special cases in the Django code to accommodate all the
database-specific options such as table type, etc. If you'd like to use any of
-these options, create an :ref:`SQL initial data file <initial-sql>` that
-contains ``ALTER TABLE`` statements that do what you want to do. The initial
-data files are executed in your database after the ``CREATE TABLE`` statements.
+these options, create a migration with a
+:class:`~django.db.migrations.operations.RunSQL` operation that contains
+``ALTER TABLE`` statements that do what you want to do.
For example, if you're using MySQL and want your tables to use the MyISAM table
-type, create an initial data file and put something like this in it::
+type, use the following SQL::
ALTER TABLE myapp_mytable ENGINE=MyISAM;
-
-As explained in the :ref:`SQL initial data file <initial-sql>` documentation,
-this SQL file can contain arbitrary SQL, so you can make any sorts of changes
-you need to make.
diff --git a/docs/faq/usage.txt b/docs/faq/usage.txt
index ecc473762f..340c737518 100644
--- a/docs/faq/usage.txt
+++ b/docs/faq/usage.txt
@@ -19,7 +19,7 @@ I can't stand your template language. Do I have to use it?
We happen to think our template engine is the best thing since chunky bacon,
but we recognize that choosing a template language runs close to religion.
There's nothing about Django that requires using the template language, so
-if you're attached to ZPT, Cheetah, or whatever, feel free to use those.
+if you're attached to Jinja2, Cheetah, or whatever, feel free to use those.
Do I have to use your model/database layer?
-------------------------------------------