#34043: Doc "Writing your first patch for Django" doesn't explain how to
contribute
to the admin UI
-------------------------------+------------------------------------
Reporter: Hugo Herter | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 1
-------------------------------+------------------------------------
Changes (by Carlton Gibson):
* version: => dev
* type: Uncategorized => New feature
* stage: Unreviewed => Accepted
Comment:
Thanks for the suggestion here. I think it's a good idea.
I see two phases here:
1. Can we improve the documentation?
2. Can we add a test project template?
On 1, there is the **smallest** of mentions in the ''Writing your first
patch for Django'' tutorial. See the
[https://docs.djangoproject.com/en/4.1/intro/contributing/#creating-
projects-with-a-local-copy-of-django Creating projects with a local copy
of Django] section.
So, question, does that need to be expanded, or put some somewhere more
prominent, or …? Had you seen that at all? Does it say enough even once
you have? (Likely not on that last)
Then on 2: I think a repo under the GitHub Django org with one or more
project templates that could be used with `startproject` and the
`--template` option would be handy. Perhaps using some of the models from
the docs. Perhaps providing fixtures so `loaddata` has something to work
on. Then linked to from the Django docs. I think that would be a great
resource. If you want to draft something and let me know we can get it set
up on GitHub.
Part 1 is clearly addressable under the scope of this issue tracker, so
let's accept for that. (It might be that we could close after that if 2
it's progressing at that time… — always allowing an update once such
exists, if that makes sense.)
🎁
--
Ticket URL: <https://code.djangoproject.com/ticket/34043#comment:3>
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 [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/010701838365801d-3851a2ce-7f8f-433d-9957-15c3273e2935-000000%40eu-central-1.amazonses.com.
