Opened 2 months ago

Closed 2 months ago

Last modified 2 months ago

#36493 closed Uncategorized (wontfix)

Docs: add clear postgresql user/db setup instructions.

Reported by: brabo Owned by: brabo
Component: Documentation Version: 5.2
Severity: Normal Keywords:
Cc: brabo Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

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.

Change History (2)

comment:1 by Tim Graham, 2 months ago

Resolution: wontfix
Status: assignedclosed

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.

comment:2 by brabo, 2 months ago

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.

Note: See TracTickets for help on using tickets.
Back to Top