[Django] #36493: Docs: add clear postgresql user/db setup instructions.

11 views
Skip to first unread message

Django

unread,
Jul 6, 2025, 11:08:20 AM7/6/25
to django-...@googlegroups.com
#36493: Docs: add clear postgresql user/db setup instructions.
-----------------------------------------+--------------------------
Reporter: brabo | Owner: brabo
Type: Uncategorized | Status: assigned
Component: Documentation | Version: 5.2
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 1
UI/UX: 0 |
-----------------------------------------+--------------------------
If a new Django user is not familiar with using postgresql yet, they may
find various instructions online to setup the database and user.
Incorrectly setting permission in the psql shell may turn into a rabbit
hole with irrelevant "fix" after "fix" being applied until it somehow Just
Works TM.
IMHO it would be really nice to add basic instructions on how to setup a
user and db that will work with the tutorial and/or provide a sane
starting point for a new project.
I am willing to provide a PR for this issue, but welcome any
comments/thoughts/ideas anyone has about my opinion in this regard, and/or
how to go about adding this info to the current documentation.
--
Ticket URL: <https://code.djangoproject.com/ticket/36493>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Jul 6, 2025, 11:27:19 AM7/6/25
to django-...@googlegroups.com
#36493: Docs: add clear postgresql user/db setup instructions.
-------------------------------+--------------------------------------
Reporter: brabo | Owner: brabo
Type: Uncategorized | Status: closed
Component: Documentation | Version: 5.2
Severity: Normal | Resolution: wontfix
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+--------------------------------------
Changes (by Tim Graham):

* resolution: => wontfix
* status: assigned => closed

Comment:

Thanks for the suggestion, however, it's out of scope for Django's
documentation. Django has several built-in database backends, and
maintaining instructions for different database versions, operating
systems, etc. quickly turns into a complicated task. Perhaps you might
suggest an improvement to PostgresSQL's documentation if you found it
lacking.
--
Ticket URL: <https://code.djangoproject.com/ticket/36493#comment:1>

Django

unread,
Jul 6, 2025, 11:42:54 AM7/6/25
to django-...@googlegroups.com
#36493: Docs: add clear postgresql user/db setup instructions.
-------------------------------+--------------------------------------
Reporter: brabo | Owner: brabo
Type: Uncategorized | Status: closed
Component: Documentation | Version: 5.2
Severity: Normal | Resolution: wontfix
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+--------------------------------------
Comment (by brabo):

My bad. Seeing specific mysql
instructions(https://docs.djangoproject.com/en/5.2/ref/databases/#mysql-
notes) and lacking instructions for postgresql made me think a simple PR
to add a few lines would be appreciated.
--
Ticket URL: <https://code.djangoproject.com/ticket/36493#comment:2>
Reply all
Reply to author
Forward
0 new messages