diff --git a/docs/topics/migrations.txt b/docs/topics/migrations.txt index 3f0a1fa68c2..b44f78cc695 100644 --- a/docs/topics/migrations.txt +++ b/docs/topics/migrations.txt @@ -67,9 +67,10 @@ PostgreSQL ---------- PostgreSQL is the most capable of all the databases here in terms of schema -support; the only caveat is that adding columns with default values will -cause a full rewrite of the table, for a time proportional to its size. +support. +The only caveat is that prior to PostgreSQL 11, adding columns with default +values causes a full rewrite of the table, for a time proportional to its size. For this reason, it's recommended you always create new columns with ``null=True``, as this way they will be added immediately.