Merge remote-tracking branch 'origin/main' into release

Author: Polybase CI

_snippets/examples/client-auth.mdx

@@ -0,0 +1,11 @@
+Open in [CodeSandbox](https://codesandbox.io/s/polybase-client-auth-vqo2ui?file=/index.html)
+
+View [Schema for example](https://explorer.testnet.polybase.xyz/collections/pk%2F0xea448a816eba719df5155f1799d014d6ce74638fc5d42780597ad7e9df046a486ba295ed1c8364d284c416b350ba6b4e4db4966faf053e98cca6cab9fd6aa266%2FTest%2FUser/schema) in explorer
+
+<iframe
+ src="https://codesandbox.io/embed/polybase-client-auth-vqo2ui?autoresize=1&fontsize=14&hidenavigation=1&theme=dark"
+  width="100%"
+  height="500px"
+  allow="accelerometer; ambient-light-sensor; camera; encrypted-media; geolocation; gyroscope; hid; microphone; midi; payment; usb; vr; xr-spatial-tracking"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+></iframe>

_snippets/examples/examples.mdx

@@ -0,0 +1,3 @@
+You can view our example apps
+[Simple CRUD](/simple-crud) and [Polybase Social](/polybase-social) to see it working in
+action.

collections.mdx

@@ -18,14 +18,55 @@ action.
 
 ## Create a collection
 
-You can create a collection using the [Explorer](https://explorer.testnet.polybase.xyz) **(recommended)** or by using the client library and calling the `applySchema` method on your polybase instance.
+### Create collection using the Explorer (recommended)
 
-<Info>
-  We recommended you use [Polybase
-  Explorer](https://explorer.testnet.polybase.xyz) to create your Collection. You will need to first login 
-  and create an account.
-</Info>
+Navigate to the [Explorer](https://explorer.testnet.polybase.xyz), and click on "Create Collection". You will then be prompted to sign in.
+
+If you create a collection in the explorer, the collection will be owned by the account you used to sign in.
+
+
+### Create collection programmatically
+
+To create a schema programatically, you can use the `applySchema` method on your Polybase client instance.
+
+In this example, we create a collection called `City` that has `name` and `country` fields, and a `setCountry()` function. You can define multiple collections in a single `applySchema` call.
+
+```js
+import { Polybase } from "@polybase/client"
+
+const db = new Polybase({ defaultNamespace: "your-namespace" })
+
+await db.applySchema(`
+  @public
+  collection City {
+    id: string;
+    name: string;
+    country?: string;
+
+    constructor (id: string, name: string) {
+      this.id = id;
+      this.name = name;
+    }
+
+    setCountry (country: string) {
+      this.country = country;
+    }
+  }
 
+  @public
+  collection Country {
+    id: string;
+    name: string;
+
+    constructor (id: string, name: string) {
+      this.id = id;
+      this.name = name;
+    }
+  }
+`,
+  "your-namespace"
+); // your-namespace is optional if you have defined a default namespace
+```
 
 <Warning>
   If you use `applySchema` you will need to sign the request [sign the request](https://docs.polybase.xyz/write#signing-requests), and 

delete-data.mdx

@@ -6,26 +6,50 @@ To delete data on Polybase, you must implement a function on your collection
 that calls `selfdestruct()`. By convention, this should be a function called
 `del()`.
 
+<Snippet file="examples/examples.mdx" /> 
+
+### Define selfdestruct in Schema
+
 The following provides an example of a delete function that only allows the
 owner of the record to delete it.
 
 ```js
 @public
-collection Place {
-  country: string;
-  owner: id;
+collection City {
+  id: string;
+  owner: PublicKey;
 
   constructor (id: string) {
     this.id = id;
-    this.owner = ctx.publicKey.toHex();
+    this.owner = ctx.publicKey;
   }
 
   del () {
-    if (owner != ctx.auth) {
-      throw error();
+    if (this.owner != ctx.publicKey) {
+      throw error("You cannot delete this record");
     }
     selfdestruct();
   }
 }
 
 ```
+
+### Call delete from the SDK
+
+You can now call the `del()` function:
+
+```js
+import { Polybase } from "@polybase/client"
+
+const db = new Polybase({ defaultNamespace: "your-namespace" });
+const collectionReference = db.collection("City");
+
+async function updateRecord () {
+  const recordData = await collectionReference
+    // the id of the record
+    .record("new-york")
+    // call the function you defined in your schema to delete a record
+    .call("del");
+}
+```
+

get-started.mdx

@@ -49,54 +49,38 @@ const db = polybase.Polybase({
 
 ## Create a collection
 
-Create collections using [Polybase Explorer](https://explorer.testnet.polybase.xyz) or the JavaScript SDK.
+You must create a collection before writing and reading data to Polybase. Create collections using [Polybase Explorer](https://explorer.testnet.polybase.xyz) **(recommended)** or programatically [using the JavaScript SDK](/collections#create-collection-programmatically).
 
-<Info>
-We suggest creating collections using [Polybase Explorer](https://explorer.testnet.polybase.xyz). You will need to first login and create an account.
-</Info>
 
-A Polybase collection describes the rules for a collection of data, not just a single record (as is the case with other smart collection languages).
+Watch Shaki create a simple collection using the Polybase Explorer. 
+<iframe width="560" height="315" src="https://www.youtube.com/embed/EKHD7i1y4jc" title="Defining a collection in Polybase Explorer" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 
-In this example we use the JavaScript SDK to create a collection called `City` that has `name` and `country` fields, and a `setCountry()` function. You can define multiple 
-collections in a single `applySchema` call.
+Here's an example Schema:
 
 ```js
-await db.applySchema(`
-  @public
-  collection City {
-    id: string;
-    name: string;
-    country?: string;
-
-    constructor (id: string, name: string) {
-      this.id = id;
-      this.name = name;
-    }
-
-    setCountry (country: string) {
-      this.country = country;
-    }
+@public
+collection City {
+  id: string;
+  name: string;
+  country?: string;
+
+  constructor (id: string, name: string) {
+    this.id = id;
+    this.name = name;
   }
 
-  @public
-  collection Country {
-    id: string;
-    name: string;
-
-    constructor (id: string, name: string) {
-      this.id = id;
-      this.name = name;
-    }
+  setCountry (country: string) {
+    this.country = country;
   }
-`,
-  "your-namespace"
-); // your-namespace is optional if you have defined a default namespace
+}
 ```
 
-For more details on creating collections, see the [collection](/collections) overview.
+<Note>
+A Polybase `collection` is just like an Ethereum `contract`, but instead of being for a single record, collections describes the rules for a set of records.
+</Note>
 
-## Create a collection record
 
+## Create a collection record
 When you create a new record, the `constructor` function in your collection is called with the parameters you provide.
 
 ```js
@@ -134,6 +118,12 @@ const db = new Polybase({ defaultNamespace: "your-namespace" });
 const data = await db.collection("City").record("new-york").get();
 ```
 
+## Live Example
+
+<Snippet file="examples/client-auth.mdx" /> 
+
+
+
 ## Next steps
 
 <Card title="Understand Collections" icon="table" href="/collections">
@@ -143,4 +133,4 @@ const data = await db.collection("City").record("new-york").get();
 </Card>
 
 <Card title="Read the Polybase Whitepaper" icon="file-lines" href="https://polybase.xyz/whitepaper">
-</Card>
+</Card>

mint.json

@@ -1,7 +1,7 @@
 {
   "name": "Polybase",
   "versions": [
-    "0.6.5"
+    "0.6.6"
   ],
   "logo": {
     "light": "/logo/light.svg",
@@ -94,6 +94,7 @@
     {
       "group": "Examples",
       "pages": [
+        "simple-crud",
         "polybase-social"
       ]
     },

read.mdx

@@ -7,9 +7,8 @@ There are two ways to retrieve data in Polybase.
 1. Fetch data once with `.get()`
 2. Listen for real time updates with `.onSnapshot()`
 
-You can view our example app
-[Polybase Social](https://social.testnet.polybase.xyz) to see it working in
-action.
+<Snippet file="examples/examples.mdx" /> 
+
 
 ## Get a single record
 

simple-crud.mdx

@@ -0,0 +1,18 @@
+---
+title: "Simple CRUD"
+---
+
+A minimal HTML example demonstrating the key features of Polybase:
+
+ - Authentication using [Polybase Auth](/authentication)
+ - [get](/read#get-a-single-record) a record from Polybase
+ - [create](/write-data#creating-a-record) new record
+ - [update](/write-data#creating-a-record) existing record using `setName()` defined in the schema
+ - [delete](/delete-data) existing record using `del()` defined in the schema
+
+
+## Example
+
+<Snippet file="examples/client-auth.mdx" /> 
+
+

write-data.mdx

@@ -4,9 +4,8 @@ title: "Write Data"
 
 You must [define a collection](/collections) before writing data to Polybase.
 
-You can view our example app
-[Polybase Social](https://social.testnet.polybase.xyz) to see it working in
-action.
+<Snippet file="examples/examples.mdx" /> 
+
 
 ## Creating a record