[D1] Creating proper API documentation

public/_redirects

@@ -294,6 +294,7 @@
 /d1/configuration/remote-development/ /d1/build-with-d1/remote-development/ 301
 /d1/build-with-d1/import-data/ /d1/build-with-d1/import-export-data/ 301
 /d1/reference/database-commands/ /d1/reference/sql-statements/ 301
+/d1/reference/sql-statements/ /d1/sql-api/sql-statements/ 301
 
 # data loss prevention (dlp)
 /cloudflare-one/policies/data-loss-prevention/integration-profiles/ /cloudflare-one/policies/data-loss-prevention/dlp-profiles/integration-profiles/ 301

src/content/docs/d1/build-with-d1/d1-client-api.mdx

@@ -449,7 +449,7 @@ D1 PRAGMA statements only apply to the current transaction.
 
 :::
 
-For the full list of PRAGMA statements supported by D1, see [SQL statements](/d1/reference/sql-statements).
+For the full list of PRAGMA statements supported by D1, see [SQL statements](/d1/sql-api/sql-statements).
 
 ## Errors
 

src/content/docs/d1/configuration/index.mdx

@@ -2,7 +2,7 @@
 title: Configuration
 pcx_content_type: navigation
 sidebar:
-  order: 4
+  order: 6
   group:
     hideIndex: true
 ---

src/content/docs/d1/d1-api.mdx

@@ -3,6 +3,6 @@ pcx_content_type: navigation
 title: D1 REST API
 external_link: /api/operations/cloudflare-d1-create-database
 sidebar:
-  order: 10
+  order: 5
 
 ---

src/content/docs/d1/demos.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: navigation
 title: Demos and architectures
 sidebar:
-  order: 8
+  order: 10
 
 ---
 

src/content/docs/d1/examples/index.mdx

@@ -4,7 +4,7 @@ hideChildren: false
 pcx_content_type: navigation
 title: Examples
 sidebar:
-  order: 6
+  order: 8
   group:
     hideIndex: true
 ---

src/content/docs/d1/observability/index.mdx

@@ -2,7 +2,7 @@
 title: Observability
 pcx_content_type: navigation
 sidebar:
-  order: 5
+  order: 7
   group:
     hideIndex: true
 ---

src/content/docs/d1/platform/index.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: navigation
 title: Platform
 sidebar:
-  order: 8
+  order: 10
   group:
     hideIndex: true
 ---

src/content/docs/d1/reference/index.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: navigation
 title: Reference
 sidebar:
-  order: 9
+  order: 11
   group:
     hideIndex: true
 ---

src/content/docs/d1/sql-api/index.mdx

@@ -0,0 +1,12 @@
+---
+title: SQL API
+pcx_content_type: navigation
+sidebar:
+  order: 5
+  group:
+    hideIndex: true
+---
+
+import { DirectoryListing } from "~/components";
+
+<DirectoryListing />

src/content/docs/d1/reference/sql-statements.mdx → src/content/docs/d1/sql-api/sql-statements.mdx

@@ -2,22 +2,33 @@
 title: SQL statements
 pcx_content_type: concept
 sidebar:
-  order: 6
+  order: 1
 ---
 
 import { Details, Render } from "~/components";
 
-D1 supports a number of database-level commands that allow you to list tables, indexes, and inspect the schema for a given table or index.
+D1 supports a number of database-level statements that allow you to list tables, indexes, and inspect the schema for a given table or index.
 
-## Database statements
+You can execute any of these statements via the D1 console in the Cloudflare dashboard, [`wrangler d1 execute`](/workers/wrangler/commands/#d1), or with the [D1 client API](/d1/worker-api/database).
 
-D1 supports a number of database-level statements that allow you to list tables, indexes, and inspect the schema for a given table or index.
+## SQLite Extensions
+
+D1 supports a subset of SQLite extensions for added functionality, including:
+
+- Default SQLite extensions.
+- [FTS5 module](https://www.sqlite.org/fts5.html) for full-text search.
 
-You can execute any of these statements via the D1 console in the Cloudflare dashboard, [`wrangler d1 execute`](/workers/wrangler/commands/#d1), or with the [D1 client API](/d1/build-with-d1/d1-client-api/).
+## Compatible PRAGMA statements
+
+D1 supports some [SQLite PRAGMA](https://www.sqlite.org/pragma.html) statements. The PRAGMA statement is an SQL extension for SQLite. PRAGMA commands can be used to:
+
+- Modify the behavior of certain SQLite operations.
+- Query the SQLite library for internal data about schemas or tables (but note that PRAGMA statements cannot query the contents of a table).
+- Control environmental variables.
 
 <Render file="use-pragma-statements" />
 
-### Query `sqlite_master`
+## Query `sqlite_master`
 
 You can also query the `sqlite_master` table to show all tables, indexes, and the original SQL used to generate them:
 
@@ -44,11 +55,21 @@ SELECT name, sql FROM sqlite_master
       }
 ```
 
-## SQLite Extensions
+## Search with LIKE
 
-D1 supports a subset of SQLite extensions for added functionality, including:
+You can perform a search using SQL's `LIKE` operator:
 
-- [FTS5 module](https://www.sqlite.org/fts5.html) for full-text search
+```js
+const { results } = await env.DB.prepare(
+	"SELECT * FROM Customers WHERE CompanyName LIKE ?",
+)
+	.bind("%eve%")
+	.all();
+console.log("results: ", results);
+```
+```js output
+results:  [...]
+```
 
 ## Related resources
 

src/content/docs/d1/tutorials/index.mdx

@@ -4,7 +4,7 @@ pcx_content_type: navigation
 title: Tutorials
 hideChildren: true
 sidebar:
-  order: 7
+  order: 9
 
 ---