- add some context to the declarative section indicating this is not

the introductory material for these topics

Change-Id: I358ba8c32520ce3950a727216bc019e33377e7b9
(cherry picked from commit 284009683d9e48e19cc09e740e7b928c2c02997c)

diff --git a/doc/build/orm/extensions/declarative/basic_use.rst b/doc/build/orm/extensions/declarative/basic_use.rst
index b23fa4044df4f5142f1d0dcb63a04d2360472349..63ab932c155f2c21b3f087a1c3b82aea28419981 100644 (file)
--- a/doc/build/orm/extensions/declarative/basic_use.rst
+++ b/doc/build/orm/extensions/declarative/basic_use.rst
@@ -2,6 +2,13 @@
 Basic Use
 =========
 
+.. seealso::
+
+    This section describes specifics about how the Declarative system
+    interacts with the SQLAlchemy ORM.  For a general introduction
+    to class mapping, see :ref:`ormtutorial_toplevel` as well as
+    :ref:`mapper_config_toplevel`.
+
 SQLAlchemy object-relational configuration involves the
 combination of :class:`.Table`, :func:`.mapper`, and class
 objects to define a mapped class.

diff --git a/doc/build/orm/extensions/declarative/inheritance.rst b/doc/build/orm/extensions/declarative/inheritance.rst
index 20a51efb22b7f7b3231c8a575ae90619b3836706..25ce986b7d89eded03caa20085c1a70124c4b798 100644 (file)
--- a/doc/build/orm/extensions/declarative/inheritance.rst
+++ b/doc/build/orm/extensions/declarative/inheritance.rst
@@ -10,8 +10,10 @@ as declarative will determine this from the class itself.   The various
 
 .. seealso::
 
-    :ref:`inheritance_toplevel` - general introduction to inheritance
-    mapping with Declarative.
+    This section describes some specific details on how the Declarative system
+    interacts with SQLAlchemy ORM inheritance configuration.  See
+    :ref:`inheritance_toplevel` for a general introduction to inheritance
+    mapping.
 
 Joined Table Inheritance
 ~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/doc/build/orm/extensions/declarative/relationships.rst b/doc/build/orm/extensions/declarative/relationships.rst
index fb53c28bb8506f697bf0be1fceec2d2b5e402d11..66eff40dfbc5f47c99e4b9660ed51f06e67f9608 100644 (file)
--- a/doc/build/orm/extensions/declarative/relationships.rst
+++ b/doc/build/orm/extensions/declarative/relationships.rst
@@ -4,6 +4,13 @@
 Configuring Relationships
 =========================
 
+.. seealso::
+
+    This section describes specifics about how the Declarative system
+    interacts with SQLAlchemy ORM relationship constructs.  For general
+    information about setting up relationships between mappings,
+    see :ref:`ormtutorial_toplevel` and :ref:`relationship_patterns`.
+
 Relationships to other classes are done in the usual way, with the added
 feature that the class specified to :func:`~sqlalchemy.orm.relationship`
 may be a string name.  The "class registry" associated with ``Base``

diff --git a/doc/build/orm/extensions/declarative/table_config.rst b/doc/build/orm/extensions/declarative/table_config.rst
index f203c55806fab06810e413c1aff1892c9ca3fc26..a14deb6aa6f697d226aeeba2a54ea90ece72d4ac 100644 (file)
--- a/doc/build/orm/extensions/declarative/table_config.rst
+++ b/doc/build/orm/extensions/declarative/table_config.rst
@@ -4,6 +4,13 @@
 Table Configuration
 ===================
 
+.. seealso::
+
+    This section describes specifics about how the Declarative system
+    defines :class:`.Table` objects that are to be mapped with the
+    SQLAlchemy ORM.  For general information on :class:`.Table` objects
+    see :ref:`metadata_describing_toplevel`.
+
 Table arguments other than the name, metadata, and mapped Column
 arguments are specified using the ``__table_args__`` class attribute.
 This attribute accommodates both positional as well as keyword