diff --git a/doc/repmgr-standby-switchover.sgml b/doc/repmgr-standby-switchover.sgml
index e551ce04..25ee61b7 100644
--- a/doc/repmgr-standby-switchover.sgml
+++ b/doc/repmgr-standby-switchover.sgml
@@ -23,7 +23,9 @@
If other standbys are connected to the demotion candidate, &repmgr; can instruct
these to follow the new primary if the option --siblings-follow
- is specified.
+ is specified. This requires a passwordless SSH connection between the promotion
+ candidate (new primary) and the standbys attached to the demotion candidate
+ (existing primary).
diff --git a/doc/switchover.sgml b/doc/switchover.sgml
index 83a3396f..18a235a9 100644
--- a/doc/switchover.sgml
+++ b/doc/switchover.sgml
@@ -60,6 +60,13 @@
&repmgr; being able to shut down the current primary server quickly and cleanly.
+
+ Ensure that a passwordless SSH connection is possible from the promotion candidate
+ (standby) to the demotion candidate (current primary). If --siblings-follow
+ will be used, ensure that passwordless SSH connections are possible from the
+ promotion candidate to all standbys attached to the demotion candidate.
+
+
Double-check which commands will be used to stop/start/restart the current
primary; on the primary execute: