Merge branch 'feat/clean-up-1' into jacob/update-architecture

Author: jacobprall

sqlite-cloud/_nav.ts

@@ -38,7 +38,6 @@ const sidebarNav: SidebarNavStruct = [
 	{ title: "Weblite", filePath: "weblite", type: "inner", level: 0 },
 		// { title: "Storage", type: "inner", level: 0 },
 	// { title: "Partitioning", type: "inner", level: 0 },
-	{ title: "Settings", filePath: "settings", type: "inner", level: 0 },
 
 	{ title: "SDKs", type: "secondary", icon: "docs-sdk" },
 	{ title: "C/C++", type: "inner", level: 0 },

sqlite-cloud/connect-cluster.mdx

@@ -8,9 +8,7 @@ slug: connect-cluster
 
 SQLite databases in SQLite Cloud are distributed across a cluster of nodes. Each cluster comes with a multi-region load balancer that routes traffic to the nearest appropriate node.
 
-To retrieve your project connection string, click the "Connect" button at the bottom of the left sidebar navigation. 
-
-Copy the connection string and use it with a client library to connect to your cluster.
+Click "Connect" in the bottom left-hand corner of your dashboard to get your connection string to use with a SQLite Cloud client library.
 
 ## Connecting with JavaScript
 Here's an example of how you can connect to your cluster using the `@sqlitecloud/drivers` JavaScript client library:

sqlite-cloud/create-database.mdx

@@ -6,7 +6,7 @@ status: publish
 slug: create-database
 ---
 
-SQLite Cloud allows you to import existing SQLite Databases, or create a new database in SQLite Cloud by importing an existing SQLite database, or using the SQLite Cloud UI, API, or client libraries.
+You can import an existing SQLite databases, or create new databases using the SQLite Cloud UI, API, or client libraries.
 
 ## Uploading an existing SQLite Database
 ### Via HTTP API
@@ -39,7 +39,7 @@ To create a new database from the SQLite Cloud UI, navigate to the Databases tab
 The default encoding is set to UTF-8, and the default page size is 4096KB.
 
 ### From the API
-To create a new database or upload an existing database via [Weblite](#), our REST API, you can make a request with the following parameters:
+To create a new database or upload an existing database via [Weblite](/docs/weblite), our REST API, you can make a request with the following parameters:
 ```bash
 curl -X 'POST' \
   'https://<your-project-id>.sqlite.cloud:8090/v2/weblite/<database-name>.sqlite' \
@@ -49,18 +49,31 @@ curl -X 'POST' \
 ```
 
 ### From client libraries
-To create a new database from a client library, use the CREATE DATABASE command. 
+To create a new database from a client library, connect to your cluster using a connection string without a specified database.
+
+Then, use the CREATE DATABASE command to create a new database. 
+
+To start using the database within the connection, you can use the `USE DATABASE` command.
 
 ```javascript
 import { Database } from '@sqlitecloud/drivers';
-
+// note that no database name is specified in the connection string path
 const db = new Database('sqlitecloud://<your-project-id>.sqlite.cloud:<your-host-port>?apikey=<your-api-key>')
 
 const createDatabase = async () => await db.sql`CREATE DATABASE <database-name>;`;
 
 createDatabase().then((res) => console.log(res));
 
 // "OK"
+
+db.exec('USE DATABASE <database-name>;')
+
+// now you can use the database
+const fetchAlbums = async () => await db.exec`SELECT * FROM albums;`;
+
+fetchAlbums().then((albums) => console.log(albums));
+
+// [{ Title: 'For Those About To Rock We Salute You', ... }, ...]
 ```
 
 ## Next Steps

sqlite-cloud/index.mdx

@@ -10,15 +10,20 @@ status: publish
 
 It has been designed from the ground up to ensure strong consistency across all nodes in a cluster while simultaneously managing the technical aspects of scaling, security, and data distribution. This ensures that you can focus on your core tasks while relying on SQLite Cloud to handle the complexities of managing your databases.
 
+SQLite Cloud is built on the open source SQLite engine, ensuring complete feature parity. You get all of SQLite's core strengths: ACID compliance, support for complex SQL operations, and compatibility with the rich SQLite extension ecosystem.
+
 You can access SQLite Cloud from the most popular programming languages or its REST API. 
 
+Like SQLite, each database in SQLite Cloud is a separate file, giving you flexible deployment options:
+
+* Create separate databases for each customer in a multi-tenant application
+* Share a single database among multiple users with built-in access controls
+* Mix both approaches based on your application's needs
+
 ### Features
 SQLite Cloud provides a comprehensive suite of tools for building realtime, local-first, edge AI applications.
-* **Local Sync**: Read and write to your local SQLite database, then synchronize with the cloud and across devices in the background. (**alpha**)
-* **Offline-first**: Automatically resolve conflicts between devices and the cloud with CRDTs. (**alpha**)
-* **[Webhooks](/docs/webhooks)**: Send changes in your database to an external webhook or use to trigger actions.
-* **[Edge Functions](/docs/edge-functions)**: Run serverless functions next to your database. Trigger via HTTP endpoint or on database operations (INSERT, UPDATE, DELETE).
+* **[Webhooks](/docs/webhooks)**: Trigger edge functions or send change payloads via HTTP, Websockets, or on database events like INSERT, UPDATE, and DELETE.
+* **[Edge Functions](/docs/edge-functions)**: Run serverless functions on the same nodes that store your data for lightning-fast data access.
 * **[Pub/Sub](/docs/pub-sub)**: Subscribe to changes in your database to replicate data, power notifications, and build multiplayer experiences.
-* **[Weblite](/docs/weblite)**: Autogenerated REST APIs to interact with your database and edge functions.
+* **[Weblite](/docs/weblite)**: Autogenerated REST APIs to interact with the SQLite Cloud platform.
 * **[Query Analyzer](/docs/analyzer)**: Receive optimization recommendations for your queries to improve performance.
-* **Multi-region Load Balancer**: Connect from anywhere and SQLite Cloud automatically routes traffic to the nearest node for optimal performance.

sqlite-cloud/platform/edge-functions.mdx

@@ -6,7 +6,7 @@ status: publish
 slug: edge-functions
 ---
 
-Edge Functions are server-side functions that run directly within your database environment. Edge functions in SQLite Cloud ensure maximum performance and minimal latency by running functions on the same server as your database.
+Edge functions let you define custom logic to run on the same nodes as your database files for ultra-fast performance.
 
 You can write edge functions directly in the SQLite Cloud dashboard using JavaScript, TypeScript, or SQL. Importing modules is not currently supported.
 

sqlite-cloud/platform/settings.mdx

@@ -6,14 +6,10 @@ status: publish
 slug: webhooks
 ---
 
-Utilize the Webhooks panel to effortlessly establish real-time notifications for write operations within your SQLite database. In this instance, we'll seamlessly notify a webhook.site service each time a write operation occurs within the albums table of the chinook.sqlite database.
+Webhooks in SQLite Cloud are a powerful way to receive and send event-based notifications.
 
-![Dashboard Projects](@docs-website-assets/introduction/dashboard_webhook_create.png)
+## Change Data Capture
+With change data webhooks, you can send notifications from SQLite Cloud to any HTTP endpoint when an insert, update or delete operation occurs on a specified database and/or table. The webhook payload includes the database name, table name, and the row data that was changed.
 
-Upon creation, you'll receive a secret value that ensures the authenticity of each notification request.
-
-![Dashboard Projects](@docs-website-assets/introduction/dashboard_webhook_create2.png)
-
-Additionally, access a comprehensive list of all enabled webhooks for your project.
-
-![Dashboard Projects](@docs-website-assets/introduction/dashboard_webhook_list.png)
+## Trigger Edge Functions
+Webhooks can also be used to trigger your edge functions, either via HTTP or Websockets request, or on a database event.

sqlite-cloud/platform/webhooks.mdx

@@ -24,7 +24,7 @@ INSERT INTO sports_cars (sc_make, sc_year) VALUES ('Ferrari', 2021);
 ```
 
 ## Writing data with the Weblite API
-You can use the API to run SQL commands against your cluster. 
+You can use the [Weblite API](/docs/weblite) to run SQL commands against your cluster. Here is an example cURL request:
 
 ```bash
 curl -X 'POST' \