diff --git a/docs/migration.txt b/docs/migration.txt
index 34613b4de..d10f699f4 100644
--- a/docs/migration.txt
+++ b/docs/migration.txt
@@ -10,6 +10,7 @@ The API for new() has changed: new( $session, $userId );
 
 editUserSettingsForm deprecated. Use editSettingsForm
 editUserSettingsFormSave is deprecated. Use editSettingsFormSave
+editUserForm and editSettingsForm now return WebGUI::FormBuilder objects instead of raw HTML.
 deleteParams is deprecated. use delete()
 deleteSingleParam is deprecated. use delete("param")
 saveParams is deprecated. use update()