Chore: Update documentation content

amotl · amotl · commit 9919250caa47 · 2023-07-31T11:32:18.000-07:00
- Add missing credits to change log
- Update to crate-docs 2.1.1
- Improve wording
- Update intersphinx reference to SQLAlchemy 2.x
diff --git a/CHANGES.txt b/CHANGES.txt
@@ -28,7 +28,7 @@ Unreleased
 
 - Allow handling datetime values tagged with time zone info when inserting or updating.
 
-- SQLAlchemy: Fix SQL statement caching for CrateDB's ``OBJECT`` type.
+- SQLAlchemy: Fix SQL statement caching for CrateDB's ``OBJECT`` type. Thanks, @faymarie.
 
 - SQLAlchemy: Refactor ``OBJECT`` type to use SQLAlchemy's JSON type infrastructure.
 
diff --git a/docs/build.json b/docs/build.json
@@ -1,5 +1,5 @@
 {
   "schemaVersion": 1,
   "label": "docs build",
-  "message": "2.1.0"
+  "message": "2.1.1"
 }
diff --git a/docs/by-example/sqlalchemy/advanced-querying.rst b/docs/by-example/sqlalchemy/advanced-querying.rst
@@ -5,8 +5,9 @@ SQLAlchemy: Advanced querying
 =============================
 
 This section of the documentation demonstrates running queries using a fulltext
-index with analyzer, queries using counting and aggregations, and support for
-the ``INSERT...FROM SELECT`` construct, all using the CrateDB SQLAlchemy dialect.
+index with an analyzer, queries using counting and aggregations, and support for
+the ``INSERT...FROM SELECT`` and ``INSERT...RETURNING`` constructs, all using the
+CrateDB SQLAlchemy dialect.
 
 
 .. rubric:: Table of Contents
diff --git a/docs/conf.py b/docs/conf.py
@@ -11,7 +11,7 @@
 
 intersphinx_mapping.update({
     'py': ('https://docs.python.org/3/', None),
-    'sa': ('https://docs.sqlalchemy.org/en/14/', None),
+    'sa': ('https://docs.sqlalchemy.org/en/20/', None),
     'urllib3': ('https://urllib3.readthedocs.io/en/1.26.13/', None),
     'dask': ('https://docs.dask.org/en/stable/', None),
     'pandas': ('https://pandas.pydata.org/docs/', None),
diff --git a/docs/sqlalchemy.rst b/docs/sqlalchemy.rst
@@ -28,7 +28,7 @@ The CrateDB SQLAlchemy dialect is validated to work with SQLAlchemy versions
 .. SEEALSO::
 
     For general help using SQLAlchemy, consult the :ref:`SQLAlchemy tutorial
-    <sa:ormtutorial_toplevel>` or the `SQLAlchemy library`_.
+    <sa:unified_tutorial>` or the `SQLAlchemy library`_.
 
     Supplementary information about the CrateDB SQLAlchemy dialect can be found
     in the :ref:`data types appendix <data-types-sqlalchemy>`.

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"schemaVersion": 1,`
`3`	`3`	`"label": "docs build",`
`4`		`- "message": "2.1.0"`
	`4`	`+ "message": "2.1.1"`
`5`	`5`	`}`