diff --git a/doc/hooks.rst b/doc/hooks.rst
index 864506bcf430ababb0009d21ff417e9d119bb901..4b460091329727097ba533d34fb795e0bfd0f078 100644
--- a/doc/hooks.rst
+++ b/doc/hooks.rst
@@ -255,7 +255,9 @@ Modifies the instance parameters.
 OP_INSTANCE_FAILOVER
 ++++++++++++++++++++
 
-Failovers an instance.
+Failovers an instance. In the post phase INSTANCE_PRIMARY and
+INSTANCE_SECONDARIES refer to the nodes that were repectively primary
+and secondary before failover.
 
 :directory: instance-failover
 :env. vars: IGNORE_CONSISTENCY
@@ -265,7 +267,9 @@ Failovers an instance.
 OP_INSTANCE_MIGRATE
 ++++++++++++++++++++
 
-Migrates an instance.
+Migrates an instance. In the post phase INSTANCE_PRIMARY and
+INSTANCE_SECONDARIES refer to the nodes that were repectively primary
+and secondary before migration.
 
 :directory: instance-migrate
 :env. vars: MIGRATE_LIVE, MIGRATE_CLEANUP