- add a tl;dr to postgresql search_path section as it's long

and will be easier to read if we know where it's going first.

Change-Id: I2766cf4655451ed514d4dc95ac60406b9f4a8ddb

diff --git a/lib/sqlalchemy/dialects/postgresql/base.py b/lib/sqlalchemy/dialects/postgresql/base.py
index 0160239b753d7c08bde15de5daffcfe43662fd7b..c9270943b759f956b6942183ebed0fe1a41a74bb 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/base.py
+++ b/lib/sqlalchemy/dialects/postgresql/base.py
@@ -125,6 +125,9 @@ Valid values for ``isolation_level`` include:
 Remote-Schema Table Introspection and PostgreSQL search_path
 ------------------------------------------------------------
 
+**TL;DR;**: keep the ``search_path`` variable set to its default of ``public``,
+name schemas **other** than ``public`` explicitly within ``Table`` defintitions.
+
 The PostgreSQL dialect can reflect tables from any schema.  The
 :paramref:`.Table.schema` argument, or alternatively the
 :paramref:`.MetaData.reflect.schema` argument determines which schema will