remove local TOC and old compatibility notes

Author: bmunkholm

docs/appendices/compatibility.rst

@@ -4,12 +4,6 @@
 Connect to CrateDB
 ==================
 
-.. rubric:: Table of contents
-
-.. contents::
-   :local:
-
-
 .. _introduction:
 
 Introduction

docs/appendices/index.rst

@@ -4,11 +4,6 @@
 Data types
 ==========
 
-.. rubric:: Table of contents
-
-.. contents::
-   :local:
-
 Type mapping
 ============
 

docs/connect.rst

@@ -5,17 +5,11 @@ Installation
 Learn how to install and get started with the :ref:`CrateDB JDBC driver
 <index>`.
 
-.. rubric:: Table of contents
-
-.. contents::
-   :local:
-
 Prerequisites
 =============
 
 The CrateDB JDBC driver requires Java 8, preferably update 20 or later. We
 recommend using `Oracle’s Java`_ on macOS and `OpenJDK`_ on Linux Systems.
-Please also consult the :ref:`compatibility-notes` for additional information.
 
 Install
 =======

docs/appendices/data-types.rst renamed to docs/data-types.rst

@@ -4,35 +4,19 @@
 CrateDB JDBC Driver
 ###################
 
-.. rubric:: Table of contents
-
-.. contents::
-    :local:
-    :depth: 1
-
-
 ************
 Introduction
 ************
 
-A `JDBC`_ driver for `CrateDB`_, based on the `PostgreSQL JDBC Driver`_.
-It can be used with CrateDB version 0.38.0 and newer.
-
-This is a `JDBC Type 4 driver`_, adhering to the `JDBC 4.1 specification`_. It
-is written in pure Java, and communicates with the database using the
-`PostgreSQL Wire Protocol`_.
-
-`JDBC`_  is a standard Java API that provides common interfaces for accessing
-databases in Java.
-
+A `JDBC`_ driver for `CrateDB`_, based on the `PostgreSQL JDBC Driver`_ which is adhering to the `JDBC 4.1 specification`_. It is written in pure Java, and communicates with the database using the `PostgreSQL Wire Protocol`_.
 
 .. _synopsis:
 
 ********
 Synopsis
 ********
 
-Connect to CrateDB instance running on ``localhost``.
+Connect to CrateDB instance running on ``localhost``:
 
 .. code-block:: java
 
@@ -41,7 +25,7 @@ Connect to CrateDB instance running on ``localhost``.
 
     Connection conn = DriverManager.getConnection("jdbc:crate://localhost:5432/");
 
-Connect to CrateDB Cloud.
+Connect to CrateDB Cloud:
 
 .. code-block:: java
 
@@ -56,23 +40,6 @@ Connect to CrateDB Cloud.
 
     Connection conn = DriverManager.getConnection("jdbc:crate://example.aks1.westeurope.azure.cratedb.net:5432/?user=crate", connectionProps);
 
-
-*************
-Documentation
-*************
-
-For general help about `JDBC`_, please consult the `JDBC tutorial`_ and the `JDBC
-API documentation`_.
-
-.. toctree::
-    :titlesonly:
-
-    getting-started
-    connect
-    appendices/index
-    internals
-
-
 .. _examples:
 
 Examples
@@ -88,52 +55,39 @@ Examples
   and the accompanying repositories `Apache Kafka, Apache Flink, and CrateDB`_
   and `Flink example jobs for CrateDB`_.
 
+*************
+Documentation
+*************
 
+For general help about `JDBC`_, please consult the `JDBC tutorial`_ and the `JDBC API documentation`_.
 
-*******************
-Project information
-*******************
+.. toctree::
+    :titlesonly:
 
-Resources
-=========
-- `Source code <https://github.com/crate/crate-jdbc>`_
-- `Documentation <https://crate.io/docs/jdbc/>`_
-- `Maven Repository <https://repo1.maven.org/maven2/io/crate/>`_
+    getting-started
+    connect
+    data-types
+    internals
 
-Contributions
-=============
-The CrateDB JDBC driver library is an open source project, and is
-managed on GitHub. Every kind of contribution, feedback, or patch, is much
-welcome. `Create an issue`_ or submit a patch if you think we should include a
-new feature, or to report or fix a bug.
 
-Development
-===========
-In order to setup a development environment on your workstation, please head
-over to the `development sandbox`_ documentation. When you see the software
-tests succeed, you should be ready to start hacking.
+.. SEEALSO::
 
-License
-=======
-The project is licensed under the terms of the Apache 2.0 license, like
-`CrateDB itself <CrateDB source_>`_, see `LICENSE`_.
+    The CrateDB JDBC driver is an open source project and is `hosted on
+    GitHub`_. Every kind of contribution, feedback, or patch, is much
+    welcome!
 
 
 .. _Apache Kafka, Apache Flink, and CrateDB: https://github.com/crate/cratedb-examples/tree/main/framework/flink
 .. _Basic example for connecting to CrateDB and CrateDB Cloud using JDBC: https://github.com/crate/cratedb-examples/tree/main/by-language/java-jdbc
 .. _Build a data ingestion pipeline using Kafka, Flink, and CrateDB: https://dev.to/crate/build-a-data-ingestion-pipeline-using-kafka-flink-and-cratedb-1h5o
 .. _CrateDB: https://crate.io/products/cratedb/
 .. _CrateDB source: https://github.com/crate/crate
-.. _Create an issue: https://github.com/crate/crate-jdbc/issues
-.. _development sandbox: https://github.com/crate/crate-jdbc/blob/master/DEVELOP.rst
 .. _Flink example jobs for CrateDB: https://github.com/crate/cratedb-flink-jobs
 .. _hosted on GitHub: https://github.com/crate/crate-jdbc/
 .. _JDBC: https://en.wikipedia.org/wiki/Java_Database_Connectivity
 .. _JDBC 4.1 specification: https://download.oracle.com/otn-pub/jcp/jdbc-4_1-mrel-spec/jdbc4.1-fr-spec.pdf
 .. _JDBC API documentation: https://docs.oracle.com/javase/8/docs/technotes/guides/jdbc/
 .. _JDBC tutorial: https://docs.oracle.com/javase/tutorial/jdbc/basics/
-.. _JDBC Type 4 driver: https://en.wikipedia.org/wiki/JDBC_driver#Type_4_driver_%E2%80%93_Database-Protocol_driver/Thin_Driver_(Pure_Java_driver)
-.. _LICENSE: https://github.com/crate/crate-jdbc/blob/master/LICENSE
 .. _PostgreSQL JDBC Driver: https://github.com/pgjdbc/pgjdbc
 .. _PostgreSQL Wire Protocol: https://www.postgresql.org/docs/current/protocol.html
 .. _sample application: https://github.com/crate/crate-sample-apps/tree/main/java-spring