diff --git a/doc/appendix-faq.sgml b/doc/appendix-faq.sgml
index d879e7f9..8d3581e0 100644
--- a/doc/appendix-faq.sgml
+++ b/doc/appendix-faq.sgml
@@ -69,6 +69,29 @@
in a streaming replication cluster.
+
+
+ Can &repmgr; assist with upgrading a PostgreSQL cluster?
+
+ For minor version upgrades, e.g. from 9.6.7 to 9.6.8, a common
+ approach is to upgrade a standby to the latest version, perform a
+ switchover promoting it to a primary,
+ then upgrade the former primary.
+
+
+ For major version upgrades (e.g. from PostgreSQL 9.6 to PostgreSQL 10),
+ the traditional approach is to "reseed" a cluster by upgrading a single
+ node with pg_upgrade
+ and recloning standbys from this.
+
+
+ To minimize downtime during major upgrades, for more recent PostgreSQL
+ versions pglogical
+ can be used to set up a parallel cluster using the newer PostgreSQL version,
+ which can be kept in sync with the existing production cluster until the
+ new cluster is ready to be put into production.
+
+