chore: add experimental documentation

Signed-off-by: Arjun Raja Yogidas <[email protected]>

Author: coderbirju

docs/opa-middleware.md

@@ -1,6 +1,20 @@
-# Applying OPA authz policies
+# OPA Authorization Middleware (Experimental)
 
-This guide provides instructions for setting up [OPA](https://github.com/open-policy-agent/opa) authz policies with the finch-daemon. Authz policies allow users to allowlist or deny certain resources based on policy rules.
+> ⚠️ **Experimental Feature**: The OPA authorization middleware is being introduced as an experimental feature.
+
+This guide provides instructions for setting up [OPA](https://github.com/open-policy-agent/opa) authorization policies with the finch-daemon. These policies allow users to allowlist or deny certain resources based on policy rules.
+
+## Experimental Status
+
+This feature is being released as experimental because:
+- Integration patterns and best practices are still being established
+- Performance characteristics are being evaluated
+
+As an experimental feature:
+- Breaking changes may occur in any release
+- Long-term backward compatibility is not guaranteed
+- Documentation and examples may evolve substantially
+- Production use is not recommended at this stage
 
 ## What Is OPA Authz implementation
 Open Policy Agent (OPA) is an open-source, general-purpose policy engine that enables unified, context-aware policy enforcement across the entire stack. OPA provides a high-level declarative language, Rego, for specifying policy as code and simple APIs to offload policy decision-making from your software.

docs/sample-rego-policies/example.rego

@@ -1,3 +1,8 @@
+# This is an experimental preview policy example.
+# As this feature is under active development:
+# - Breaking changes may occur without notice
+# - Production use is not recommended
+
 package finch.authz
 
 import future.keywords.if