Documentation Contradiction: insert methods inside a change() method

Under the Inserting Data heading, there's a yellow warning: "You cannot use the insert methods inside a change() method. Please use the up() and down() methods."

But just above on the same page, under The Change Method the last code sample invokes an insert() method from within the change() method.

If this code sample is actually valid, is it because the invocation of insert() is conditional based on isMigratingUp()? If so, that should be explained in the yellow warning under Inserting Data.

Perhaps this:

"Please use the up() and down() methods."

Could be changed to this:

"Please use the up() and down() methods, or when inside a change() method only invoke insert() inside a conditional block when isMigratingUp() or isMigratingDown() is true."

Read the linked “The Change Method” and “Inserting Data” sections in the Phinx documentation, especially the final change() example and the yellow warning. Verify whether the example’s conditional use of insert() is valid, then reconcile the warning and example so the documented rule is consistent.