Documentation: Improve text layout/flow

amotl · amotl · commit 524936e5b9f9 · 2023-09-06T06:49:11.000-07:00
diff --git a/docs/by-example/index.rst b/docs/by-example/index.rst
@@ -4,13 +4,8 @@
 By example
 ##########
 
-
-*****
-About
-*****
-
-This part of the documentation contains examples how to use the CrateDB Python
-client.
+This part of the documentation enumerates different kinds of examples how to
+use the CrateDB Python client.
 
 
 DB API, HTTP, and BLOB interfaces
diff --git a/docs/index.rst b/docs/index.rst
@@ -36,11 +36,9 @@ Documentation
 For general help about the Python Database API, or SQLAlchemy, please consult
 `PEP 249`_, the `SQLAlchemy tutorial`_, and the general `SQLAlchemy
 documentation`_.
-
 For more detailed information about how to install the client driver, how to
 connect to a CrateDB cluster, and how to run queries, consult the resources
-referenced below. A dedicated section demonstrates how to use the :ref:`blob
-storage capabilities <crate-reference:blob_support>` of CrateDB.
+referenced below.
 
 .. toctree::
     :titlesonly:
