Refactor how we access ORM model configuration

docs/source/changelog.rst

@@ -26,6 +26,7 @@ Changelog
   - `PR #362 <https://github.com/gtalarico/pyairtable/pull/362>`_.
 * Added ORM fields that :ref:`require a non-null value <Required Values>`.
   - `PR #363 <https://github.com/gtalarico/pyairtable/pull/363>`_.
+* Refactored methods for accessing ORM model configuration.
 
 2.3.3 (2024-03-22)
 ------------------------

docs/source/migrations.rst

@@ -9,10 +9,15 @@ Migration Guide
 Migrating from 2.x to 3.0
 ============================
 
-In this release we've made breaking changes to the :mod:`pyairtable.formulas` module.
-In general, most functions and methods in this module will return instances of
+In this release we've made a number of breaking changes, summarized below.
+
+Changes to the formulas module
+---------------------------------------------
+
+Most functions and methods in :mod:`pyairtable.formulas` now return instances of
 :class:`~pyairtable.formulas.Formula`, which can be chained, combined, and eventually
 passed to the ``formula=`` keyword argument to methods like :meth:`~pyairtable.Table.all`.
+Read the module documentation for more details.
 
 The full list of breaking changes is below:
 
@@ -49,6 +54,24 @@ The full list of breaking changes is below:
       - These no longer return ``str``, and instead return instances of
         :class:`~pyairtable.formulas.FunctionCall`.
 
+Changes to retrieving ORM model configuration
+---------------------------------------------
+
+The 3.0 release has changed the API for retrieving ORM model configuration:
+
+.. list-table::
+    :header-rows: 1
+
+    * - Method in 2.x
+      - Method in 3.0
+    * - ``Model.get_api()``
+      - ``Model.meta.api``
+    * - ``Model.get_base()``
+      - ``Model.meta.base``
+    * - ``Model.get_table()``
+      - ``Model.meta.table``
+    * - ``Model._get_meta(name)``
+      - ``Model.meta.get(name)``
 
 Migrating from 2.2 to 2.3
 ============================