From 373c88cb6a09da04bdcbf03a6306b2f9fc03b960 Mon Sep 17 00:00:00 2001
From: Charlie Egan <charlie@styra.com>
Date: Wed, 18 Dec 2024 11:30:46 +0000
Subject: [PATCH] docs: Add v0 import example

Signed-off-by: Charlie Egan <charlie@styra.com>
---
 docs/content/v0-compatibility.md | 42 ++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/docs/content/v0-compatibility.md b/docs/content/v0-compatibility.md
index 14535f451e..8b4e914969 100644
--- a/docs/content/v0-compatibility.md
+++ b/docs/content/v0-compatibility.md
@@ -111,6 +111,48 @@ r := rego.New(
 )
 ```
 
+Finally, another option is to import the `v0` package instead. The program
+
+below imports the v0 package instead:
+
+```go
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+
+	"github.com/open-policy-agent/opa/rego"
+    // rather than the v1 import, which is:
+	// "github.com/open-policy-agent/opa/v1/rego"
+)
+
+func main() {
+	module := `package example
+messages[msg] {
+	msg := "foo"
+}
+`
+
+	r := v0rego.New(
+		rego.Query("data.example.messages"),
+		rego.Module("example.rego", module),
+	)
+
+	rs, _ = rv0.Eval(context.TODO())
+	bs, _ = json.Marshal(rs)
+
+	fmt.Println(string(bs))
+}
+```
+
+{{< danger >}}
+**Note**: Using v0 packages and v1 packages in the same program is considered an
+anti-pattern and is not recommended or supported. Any interoperability between
+the two packages is not guaranteed and should be considered unsupported.
+{{< /danger >}}
+
 ### v0.x compatibility mode in the OPA Go SDK
 
 {{< info >}}