#23648: Documentation suggestion from new Django student.
-------------------------------+----------------------------------
Reporter: kielhorn | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: 1.7
Severity: Normal | Keywords: tutorial settings.py
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+----------------------------------
I am new to Django. I suggest the following change to the tutorial. I was
confused by the use of the word 'default', which I think should be
removed. Please see below. My confusion led to errors when executing
'python manage.py migrate'
Thanks.
Documentation version: 1.7
Section: Writing your first Django app, part 1
Subsection: Database setup
paragraph-2:
"By default, the configuration uses SQLite."
--- The above line is confusing. It suggests
that by doing nothing to settings.py the
sqlite3 database will be used, when actually
'ENGINE' must be set to django.db.backends.sqlite3
and 'NAME' must be set to something.
My suggested wording for this paragraph is:
" The simplest database to use is SQLite.
If you're new to databases, or you're just interested in
trying Django,
this is the easiest choice. SQLite is included in Python,
so you won't need to install anything else to support your
database.
To specify SQLite, you must edit settings.py and set 'ENGINE'
to
'django.db.backends.sqlite3'. You must also set 'NAME' to
some value,
for example, 'myName'."
--
Ticket URL: <https://code.djangoproject.com/ticket/23648>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to django-updates+unsubscr...@googlegroups.com.
To post to this group, send email to django-updates@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/051.bffc7a4524d478ae5a717e879bf8823a%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
