Clarify database compatibility guidance

Author: ejboy

howto/create-database.html

@@ -66,7 +66,7 @@ <h2>Documentation</h2>
 
     <article class="page-content">
       <h1>Create and initialize a database</h1>
-      <p class="lede">Start by creating an empty database with the database server's own tools. Once it exists, Scriptella can create schema objects, run SQL scripts, load initial data, import data, or migrate data from another database.</p>
+      <p class="lede">Scriptella supports many databases through JDBC; see the <a href="../reference/drivers.html">drivers matrix</a> for database adapters and compatibility details. The examples below use PostgreSQL and MariaDB. Once a database exists, Scriptella can create schema objects, run SQL scripts, load initial data, import data, or migrate data from another database.</p>
 
       <section id="postgresql">
         <h2>PostgreSQL</h2>

reference/drivers.html

@@ -64,23 +64,18 @@ <h1>Scriptella drivers matrix</h1>
       <section id="jdbcbridge">
         <h2>JDBC bridge drivers</h2>
         <p>Scriptella provides built-in adapters for popular databases. See the <a href="../docs/api/scriptella/jdbc/package-summary.html#package.description">JDBC bridge Javadoc</a> for common properties and behaviour.</p>
-        <aside class="note" aria-label="Removed 1.3 adapters">
-          <strong>Note:</strong> Scriptella 1.4 removes the HSQLDB and JDBC-ODBC adapters. Remain on <a href="../download.html#version-1-3">Scriptella 1.3</a> if you still need those drivers.
-        </aside>
+        <p>
+          Current JDBC guidance covers PostgreSQL, MariaDB, MySQL, Oracle, and SQL
+          Server. PostgreSQL and MariaDB have full
+          release validation; MySQL has targeted validation, while Oracle and SQL
+          Server remain provisional. See the <a
+          href="https://github.com/scriptella/scriptella-etl/blob/master/docs/core-database-compatibility.md">core
+          database compatibility matrix</a> for details, driver links, and
+          <code>classpath</code> examples.
+        </p>
         <aside class="note" aria-label="Note">
           <strong>Note:</strong> JDBC adapters are recommended, but any JDBC-compliant driver can be used directly.
         </aside>
-        <aside class="note" aria-label="Scriptella 1.5 database compatibility">
-          <strong>Scriptella 1.5:</strong> PostgreSQL and MariaDB have recorded full
-          release validation with current drivers. MySQL has one targeted MySQL
-          8.4.11 / Connector/J 26.7.0 lane. Oracle and SQL Server use current
-          preferred driver classes but remain provisional because they do not
-          yet have real-server matrix results. Vendor JDBC JARs are supplied
-          externally through a connection <code>classpath</code>. See the <a
-          href="https://github.com/scriptella/scriptella-etl/blob/master/docs/core-database-compatibility.md">core
-          database compatibility matrix</a> for validation targets, driver
-          download links, and connection <code>classpath</code> examples.
-        </aside>
         <div class="table-scroll" tabindex="0" role="region" aria-label="JDBC bridge drivers">
           <table class="drivers-matrix">
             <thead>
@@ -179,6 +174,9 @@ <h2>JDBC bridge drivers</h2>
             </tbody>
           </table>
         </div>
+        <aside class="note" aria-label="Removed 1.3 adapters">
+          <strong>Note:</strong> Scriptella 1.4 removes the HSQLDB and JDBC-ODBC adapters. Remain on <a href="../download.html#version-1-3">Scriptella 1.3</a> if you still need those drivers.
+        </aside>
       </section>
 
       <section id="nonjdbc">