#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 , 2 months ago
Resolution: | → wontfix |
---|---|
Status: | assigned → closed |
comment:2 by , 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.
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.