[KV] Drafting a more detailed Overview page for Workers KV.

src/content/docs/kv/index.mdx

@@ -12,6 +12,9 @@ import {
 	LinkTitleCard,
 	Plan,
 	RelatedProduct,
+	Tabs,
+	TabItem,
+	LinkButton
 } from "~/components";
 
 <Description>
@@ -22,8 +25,97 @@ Create a global, low-latency, key-value data storage.
 
 <Plan type="workers-all" />
 
+## What is Workers KV?
+
 Workers KV is a data storage that allows you to store and retrieve data globally. With Workers KV, you can build dynamic and performant APIs and websites that support high read volumes with low latency.
 
+For example, you can use Workers KV for:
+
+- Caching API responses.
+- Storing user configurations / preferences.
+- Storing user authentication details.
+
+Workers KV is ideal for projects that require:
+
+- High volumes of reads and/or repeated reads to the same keys.
+- Per-object time-to-live (TTL).
+- Distributed configuration.
+
+**Code examples**
+
+<Tabs>
+<TabItem label="REST API">
+```
+curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/storage/kv/namespaces/$NAMESPACE_ID/values/$KEY_NAME \
+    -X PUT \
+    -H 'Content-Type: multipart/form-data' \
+    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
+    -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \
+    -d '{
+      "value": "Some Value"
+    }'
+
+curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/storage/kv/namespaces/$NAMESPACE_ID/values/$KEY_NAME \
+    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
+    -H "X-Auth-Key: $CLOUDFLARE_API_KEY"
+```
+</TabItem>
+<TabItem label="Workers Binding API">
+```ts
+export interface Env {
+	YOUR_BINDING: KVNamespace;
+}
+
+export default {
+	async fetch(request, env, ctx): Promise<Response> {
+
+		//write a key-value pair
+		await env.YOUR_BINDING.put('KEY', 'VALUE');
+
+		// read a key-value pair
+		const value = await env.YOUR_BINDING.get('KEY');
+
+		//list all key-value pairs
+		const allKeys = await env.YOUR_BINDING.list();
+
+		//delete a key-value pair
+		await env.YOUR_BINDING.delete('KEY');
+
+		//return a Workers response
+		return new Response(
+			JSON.stringify({
+				value: value,
+				allKeys: allKeys,
+			}),
+		);
+	},
+};
+
+```
+</TabItem>
+<TabItem label="wrangler.json">
+```json
+{
+	"$schema": "node_modules/wrangler/config-schema.json",
+	"name": "WORKER-NAME",
+	"main": "src/index.ts",
+	"compatibility_date": "2025-02-04",
+	"observability": {
+		"enabled": true
+	},
+
+	"kv_namespaces": [
+		{
+			"binding": "YOUR_BINDING",
+			"id": "<YOUR_BINDING_ID>"
+		}
+	]
+```
+</TabItem>
+</Tabs>
+
+Learn more about Workers KV [key concepts](/kv/how-kv-works/), or [get started](kv/get-started/).
+
 ---
 
 ## Features