#10137: windows documentation suggestion
------------------------------------+---------------------------------------
Reporter: emdog4 | Owner: nobody
Status: closed | Milestone:
Component: Documentation | Version: 1.0
Resolution: invalid | Keywords: windows sqlite3
settings.py
Stage: Unreviewed | Has_patch: 0
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |
------------------------------------+---------------------------------------
Changes (by kmtracey):
* status: new => closed
* needs_better_patch: => 0
* resolution: => invalid
* needs_tests: => 0
* needs_docs: => 0
Comment:
It would help if you identified what doc you are talking about. (Also,
the title mentions "windows" but I don't understand how there is anything
Windows-specific about this -- you need to specify the database file name
when using sqlite on all platforms, not just Windows.)
The most natural place for a first-time user to encounter setting up a
database is, I think, the tutorial. The tutorial doc for this is here:
http://docs.djangoproject.com/en/dev/intro/tutorial01/#database-setup
and it seems pretty clear that you have to specify a name.
If you bypass the tutorial and go to the doc on settings directly, this is
the doc:
http://docs.djangoproject.com/en/dev/ref/settings/#database-name
which, again, clearly states this is the name of the database file in the
case of sqlite.
If you bypass reading the doc entirely and just go by the settings
template created by startproject:
{{{
DATABASE_NAME = '' # Or path to database file if using
sqlite3.
}}}
The comment mentions this is the database file when using sqlite, so it
seems clear to me it is something you will need to set to a value if using
sqlite3.
If you still think the doc is unclear here, feel free to reopen with a
pointer to exactly where you see information missing. It'll have a better
chance of geting incorporated if you also provide a patch that shows how
you think things could be made clearer.
--
Ticket URL: <http://code.djangoproject.com/ticket/10137#comment:1>
Django <http://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 post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
