update fundamentals and edge functions

Author: jacobprall

sqlite-cloud/connect-cluster.mdx

@@ -8,10 +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.
 
-For this reason, we strongly recommend connecting to your cluster via your project connection string. To retrieve your project connection string, navigate to the **Nodes** page and click on any node. 
-{/* ![Project connection string modal](@docs-website-assets/connect-cluster-1.png) */}
-
-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.
 
 ## Importing an existing SQLite database
 SQLite Cloud allows you to import existing SQLite databases into the platform. 
@@ -27,7 +27,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' \
@@ -37,17 +37,30 @@ 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', ... }, ...]
 ```
 

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/write-data.mdx

@@ -6,22 +6,7 @@ status: publish
 slug: write-data
 ---
 
-After you've created a database in SQLite Cloud, you can start writing data to it. You can write data to your cluster using the SQLite Cloud UI, API, or client libraries.
-
-## Upload an existing SQLite Database
-You can upload an existing SQLite database to your cluster using the SQLite Cloud UI or the Weblite API.
-
-To upload a local SQLite database via weblite, make a POST request to the `/v2/weblite/<database-name>.sqlite` endpoint.
-
-```bash
-curl -X 'POST' \
-  'https://<your-project-id>.sqlite.cloud:8090/v2/weblite/<database-name>.sqlite' \
-  -H 'accept: application/json' \
-  -H 'Authorization: Bearer sqlitecloud://<your-project-id>.sqlite.cloud:8860?apikey=<your-api-key' \
-  -d ''
-```
-
-To upload a local SQLite database via the SQLite Cloud UI, navigate to the Database tab in the left-hand navigation. Click the "Upload Database" button and select your local SQLite database.
+After you've created a database in SQLite Cloud, you can start writing data to it.
 
 ## Writing data with the SQLite Cloud UI
 Navigate to the console tab in the left-hand navigation. From here, you can run SQL commands against your cluster. Use the optional dropdown menus to select a database and table.
@@ -39,7 +24,7 @@ INSERT INTO sports_cars (sc_name, sc_year, image) VALUES ('Ferrari', 2021, 'http
 ```
 
 ## 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' \
@@ -57,7 +42,7 @@ import { Database } from '@sqlitecloud/drivers';
 
 const db = new Database('sqlitecloud://<your-project-id>.sqlite.cloud:<your-host-port>?apikey=<your-api-key>')
 db.exec('USE DATABASE mydatabase.sqlite;')
-db.exec('CREATE TABLE sports_cars (sc_id INTEGER PRIMARY KEY, sc_name TEXT NOT NULL, sc_year INTEGER NOT NULL, image BLOB);')
+db.exec('CREATE TABLE sports_cars (sc_id INTEGER PRIMARY KEY, sc_name TEXT NOT NULL, sc_year INTEGER NOT NULL, image_url text);')
 db.commit()
 const insertData = async () => await db.sql`INSERT INTO sports_cars (sc_name, sc_year, image) VALUES ('Ferrari', 2021, 'https://example.com/ferrari.jpg');`;