add usage examples

closes #1

examples/containerized-krm/README.md

@@ -0,0 +1,16 @@
+# Container Plugin Example
+
+This example runs `YqTransformer` as a **containerized KRM function**.
+
+## Locate the plugin image
+
+The `config.kubernetes.io/function` annotation in `yq-transformer.yaml`
+points to the plugin's image address in the `container.image` key.
+
+## Build with alpha plugins enabled
+
+```bash
+kustomize build --enable-alpha-plugins .
+```
+
+You should see a label `environment: dev` added to one of the Deployments.

examples/containerized-krm/kustomization.yaml

@@ -0,0 +1,8 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+resources:
+  - ../manifests
+
+transformers:
+  - yq-transformer.yaml

examples/containerized-krm/yq-transformer.yaml

@@ -0,0 +1,18 @@
+apiVersion: kustomize.bdeshi.space/v1
+kind: YqTransformer
+metadata:
+  name: yq-transformer-dev-label # this can be anything
+  annotations:
+    config.kubernetes.io/function: |
+      container:
+        image: ghcr.io/bdeshi/kustomize-plugin-yqtransformer:latest
+targets:
+  - apiVersion: apps/v1
+    kind: Deployment
+    spec:
+      template:
+        spec:
+          serviceAccountName: dev-app
+expression: |
+  .metadata.labels.environment = "dev"
+  | .spec.template.metadata.labels.environment = "dev"