Changes between Initial Version and Version 2 of Ticket #24989


Ignore:
Timestamp:
Jun 16, 2015, 9:01:43 AM (9 years ago)
Author:
Markus Holtermann
Comment:

Legend:

Unmodified
Added
Removed
Modified

  • Ticket #24989

    • Property Owner changed from nobody to Markus Holtermann
    • Property Triage Stage Unreviewed → Accepted
    • Property Status new → assigned
    • Property Summary Introduce low-level documentation on Django's components → Introduce contributor facing documentation for django.db.migrations

  • Ticket #24989 – Description

    initial v2  
    1 I first had the idea a Django: Under the Hood 2014, but abandoned it. A couple of days ago the idea came up in IRC again:
     1It 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/`
    22
    3 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.
    4 
    5 I.e. 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.
    6 
    7 Tim proposed to add that documentation to `docs/internals/`. I'd put it into `docs/internals/api/`
     3E.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.
Back to Top