diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index 1fe27c5da9..f47170cb35 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -3583,6 +3583,26 @@ VALUES ('Albany', NULL, NULL, 'NY');
offer flexibility but do not have some of the performance benefits
of built-in declarative partitioning.
+
+
+
+ When using table inheritance, partitioning hierarchies with more than a
+ few hundred partitions are not currently recommended. Larger partition
+ hierarchies may incur long planning time, and especially in the case of
+ UPDATE and DELETE, excessive
+ memory usage. When inheritance is used, see also the limitations
+ described in .
+
+
+
+ When using declarative partitioning, the effort required by the planner
+ is closely tied to the number of unpruned partitions. Planning is
+ generally fast with small numbers of unpruned partitions even in
+ partitioning hierarchies containing many thousands of partitions.
+ However, planning queries where partition pruning is not possible during
+ planning are likely to be slow with such large partitioning hierarchies.
+
+