Opened 9 years ago
Last modified 10 months ago
#24989 new New feature
Introduce contributor facing documentation for django.db.migrations — at Version 2
Reported by: | Markus Holtermann | Owned by: | Markus Holtermann |
---|---|---|---|
Component: | Documentation | Version: | dev |
Severity: | Normal | Keywords: | |
Cc: | Triage Stage: | Accepted | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description (last modified by )
It would be helpful for new contributors as well as for other core devs not involved in certain parts of Django, to have documentation that outlines how these components work. Tim proposed to add that documentation to docs/internals/
. I'd put it into docs/internals/api/
E.g. in migrations: you have a ModelState
and to detect changes the autodetector takes all migrations and build the final model representation and then compares this ProjectState
to the ProjectState
constructed from all currently available models.
Change History (2)
comment:1 by , 9 years ago
comment:2 by , 9 years ago
Description: | modified (diff) |
---|---|
Owner: | changed from | to
Status: | new → assigned |
Summary: | Introduce low-level documentation on Django's components → Introduce contributor facing documentation for django.db.migrations |
Triage Stage: | Unreviewed → Accepted |
I think the idea is accepted, but a ticket is needed for each thing you want to document, not all of them in one ticket. Do you want to retitle this one to cover migrations?