add top-level README

Author: jimmyjames

examples/README.md

@@ -0,0 +1,11 @@
+## Examples of using the OpenFGA Java SDK
+
+A collection of examples demonstrating how to use the OpenFGA Java SDK in different scenarios.
+
+### Available Examples
+
+#### Basic Examples (`basic-examples/`)
+A simple example that creates a store, runs a set of calls against it including creating a model, writing tuples and checking for access. This example is implemented in both Java and Kotlin.
+
+#### OpenTelemetry Examples
+- `opentelemetry/` - Demonstrates OpenTelemetry integration both via manual code configuration, as well as no-code instrumentation using the OpenTelemetry java agent