diff --git a/docs/en/index.rst b/docs/en/index.rst
index 7936f48a..ecbf72c7 100644
--- a/docs/en/index.rst
+++ b/docs/en/index.rst
@@ -841,6 +841,8 @@ pass them to the method::
     // This one with the "default" connection
     $migrate = $migrations->migrate(['connection' => 'default']);
 
+.. _feature-flags:
+
 Feature Flags
 =============
 
diff --git a/docs/en/writing-migrations.rst b/docs/en/writing-migrations.rst
index 4272fbc1..6da4195d 100644
--- a/docs/en/writing-migrations.rst
+++ b/docs/en/writing-migrations.rst
@@ -549,13 +549,16 @@ comment    MySQL, Postgres  set a text comment on the table
 collation  MySQL, SqlServer set the table collation *(defaults to database collation)*
 row_format MySQL            set the table row format
 engine     MySQL            define table engine *(defaults to ``InnoDB``)*
-signed     MySQL            whether the primary key is ``signed``  *(defaults to ``false``)*
+signed     MySQL            whether the primary key is ``signed``  *(defaults to ``true``)*
 limit      MySQL            set the maximum length for the primary key
 ========== ================ ===========
 
-By default, the primary key is ``unsigned``.
-To simply set it to be signed just pass ``signed`` option with a ``true``
-value::
+By default, the primary key is ``signed``.
+To set it to be unsigned, pass the ``signed`` option with a ``false``
+value, or enable the ``Migrations.unsigned_primary_keys`` and
+``Migrations.unsigned_ints`` feature flags (see :ref:`feature-flags`).
+Both flags should be used together so that foreign key columns match
+the primary keys they reference::
 
     <?php