Rewrite the documentation for Django Evolution.

Review Request #10589 — Created June 13, 2019 and submitted

Django Evolution

The documentation for Django Evolution was criminally obsolete,
referring to specific SVN revisions of Django that are needed, types of
supported fields that apparently could not be added, and limitations
that haven't existed for many, many years.

Given how big a release the upcoming 2.0 is, it's time (long past time)
to rewrite the docs.

The new docs provide an overview of the functionality of Django
Evolution, installation, and walkthroughs of how to work with
evolutions. There's a guide to all supported mutations and how to use
them, along with caveats to be aware of. There's also a FAQ with project
information, how evolutions and migrations interoperate, and some quirks
to expect while using evolutions.

There's command references for the evolve, list-evolutions, and
wipe-evolution commands, along with a codebase reference.

This will be expanded in the future as the project changes and grows,
but this is already a much better first step. The plan is to deploy
these docs on

An upcoming change will move the release notes over to these docs.

Built the docs and read through them, checking for errors.

There are some build errors, but they're due to syntax issues in
source code that will be fixed separately.

Rewrite the documentation for Django Evolution.
Description From Last Updated

E501 line too long (80 > 79 characters)


E402 module level import not at top of file


typo: evoutions

Checks run (1 failed, 1 succeeded)
flake8 failed.
JSHint passed.


  2. docs/index.rst (Diff revision 1)

    typo: evoutions

Review request changed

Status: Closed (submitted)

Change Summary:

Pushed to master (db634c9)