docs: add docs according to the pulumi standard

Author: callicles

docs/_index.md

@@ -1,9 +1,58 @@
 ---
 title: Clickhouse
 meta_desc: Provides an overview of the Clickhouse Provider for Pulumi.
-layout: overview
+layout: package
 ---
 
-The Clickhouse provider for Pulumi can be used to provision any of the cloud resources available in Clickhouse.
+The Clickhouse provider for Pulumi can be used to provision any of the cloud resources available in [Clickhouse Cloud](https://clickhouse.cloud).
 
-The Clickhouse provider must be configured with credentials to deploy and update resources in Clickhouse.
+The Clickhouse provider must be configured with credentials to deploy and update resources in Clickhouse Cloud.
+
+## Example
+
+{{< chooser language "typescript,python" >}}
+{{% choosable language typescript %}}
+
+```typescript
+import * as clickhouse from "@pulumiverse/clickhouse";
+
+new clickhouse.Service("example", {
+    region: "us-central1",
+    cloudProvider: "gcp",
+    tier: "development",
+    password: "1234",
+    ipAccesses: [{
+        source: "0.0.0.0",
+        description: "Test IP"
+      }]
+});
+
+```
+
+{{% /choosable %}}
+{{% choosable language python %}}
+
+```python
+import pulumiverse_clickhouse as clickhouse
+
+service_account = clickhouse.Service(
+    "example",
+    region = "us-central1",
+    cloud_provider = "gcp",
+    tier = "development",
+    password =  "1234",
+    ip_accesses = [{
+        "source": "0.0.0.0",
+        "description": "Test IP"
+      }]
+)
+```
+
+{{% /choosable %}}
+{{< /chooser >}}
+
+## Issues
+
+This is a community maintained provider. Please file issues and feature requests here:
+
+[pulumiverse/pulumi-clickhouse](https://github.com/pulumiverse/pulumi-clickhouse/issues)

examples/create-clickhouse-service/py/.gitignore

@@ -0,0 +1,2 @@
+*.pyc
+venv/

examples/create-clickhouse-service/py/Pulumi.yaml

@@ -0,0 +1,11 @@
+name: py
+runtime:
+  name: python
+  options:
+    toolchain: pip
+    virtualenv: venv
+description: A minimal Python Pulumi program
+config:
+  pulumi:tags:
+    value:
+      pulumi:template: python

examples/create-clickhouse-service/py/__main__.py

@@ -0,0 +1,15 @@
+"""A Python Pulumi program"""
+
+import pulumiverse_clickhouse as clickhouse
+
+service_account = clickhouse.Service(
+    "example",
+    region = "us-central1",
+    cloud_provider = "gcp",
+    tier = "development",
+    password =  "1234",
+    ip_accesses = [{
+        "source": "0.0.0.0",
+        "description": "Test IP"
+      }]
+)

examples/create-clickhouse-service/py/requirements.txt

@@ -0,0 +1,2 @@
+pulumi>=3.0.0,<4.0.0
+pulumiverse_clickhouse>=0.0.4,

examples/create-clickhouse-service/ts/index.ts

@@ -1,4 +1,3 @@
-import * as pulumi from "@pulumi/pulumi";
 import * as clickhouse from "@pulumiverse/clickhouse";
 
 new clickhouse.Service("example", {

examples/create-clickhouse-service/ts/package-lock.json

@@ -6,6 +6,7 @@
         "typescript": "^5.0.0"
     },
     "dependencies": {
-        "@pulumi/pulumi": "^3.113.0"
+        "@pulumi/pulumi": "^3.113.0",
+        "@pulumiverse/clickhouse": "^0.0.4"
     }
 }