#21070: Clarify document DATABASES change
--------------------------------------+------------------------------------
     Reporter:  joejasinski           |                    Owner:  nobody
         Type:  Cleanup/optimization  |                   Status:  new
    Component:  Documentation         |                  Version:  master
     Severity:  Normal                |               Resolution:
     Keywords:                        |             Triage Stage:  Accepted
    Has patch:  0                     |      Needs documentation:  0
  Needs tests:  0                     |  Patch needs improvement:  0
Easy pickings:  1                     |                    UI/UX:  0
--------------------------------------+------------------------------------
Changes (by mjtamlyn):

 * needs_better_patch:   => 0
 * stage:  Unreviewed => Accepted
 * type:  Uncategorized => Cleanup/optimization
 * needs_tests:   => 0
 * needs_docs:   => 0


Comment:

 The overall gist of this is good. I think in particular that the example
 in the docs should read the same as that in the default setting file. As
 for the other example, I'd prefer to see a concrete example, probably
 using postgres, with a changed host name etc.

 To be honest, that section of documentation is so long with all the
 options I think there is some merit in separating it out into a separate
 page. That would allow for a bit more prose about the setting before the
 api docs. We may also want to restructure into common connection config,
 test config, oracle specific settings etc.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/21070#comment:1>
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/069.fd12904aa8c4963d1571dbd03a4254eb%40djangoproject.com.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to