diff --git a/README.md b/README.md
index b3b2300..967bd59 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,39 @@
-# configuration-azure-aks
-Azure AKS Configuration
+# Azure AKS Configuration
+
+
+This repository contains a [Crossplane configuration](https://docs.crossplane.io/latest/concepts/packages/#configuration-packages), tailored for users establishing their initial control plane with [Upbound](https://cloud.upbound.io). This configuration deploys fully managed [Azure AKS](https://azure.microsoft.com/en-us/products/kubernetes-service) instances.
+
+## Overview
+
+The core components of a custom API in [Crossplane](https://docs.crossplane.io/latest/getting-started/introduction/) include:
+
+- **CompositeResourceDefinition (XRD):** Defines the API's structure.
+- **Composition(s):** Implements the API by orchestrating a set of Crossplane managed resources.
+
+In this specific configuration, the AKS API contains:
+
+- **an [AKS](/apis/definition.yaml) custom resource type.**
+- **Composition of the AKS resources:** Configured in [/apis/composition.yaml](/apis/composition.yaml), it provisions an AKS cluster and resources and fundamental security and networking resources in the `upbound-system` namespace.
+
+This repository contains an Composite Resource (XR) file.
+
+## Deployment
+
+```shell
+apiVersion: pkg.crossplane.io/v1
+kind: Configuration
+metadata:
+  name: configuration-azure-aks
+spec:
+  package: xpkg.upbound.io/upbound/configuration-azure-aks:v0.3.0
+```
+
+## Next steps
+
+This repository serves as a foundational step. To enhance your control plane, consider:
+
+1. create new API definitions in this same repo
+2. editing the existing API definition to your needs
+
+
+Upbound will automatically detect the commits you make in your repo and build the configuration package for you. To learn more about how to build APIs for your managed control planes in Upbound, read the guide on Upbound's docs.
diff --git a/crossplane.yaml b/crossplane.yaml
index b34f306..492db83 100644
--- a/crossplane.yaml
+++ b/crossplane.yaml
@@ -6,6 +6,11 @@ metadata:
     meta.crossplane.io/maintainer: Upbound <support@upbound.io>
     meta.crossplane.io/source: github.com/upbound/configuration-azure-aks
     meta.crossplane.io/license: Apache-2.0
+    meta.crossplane.io/description: |
+      Azure AKS Configuration is reusable Configuration designed to be primarily used in higher level Configurations.
+    meta.crossplane.io/readme: |
+      This configuration bundles an Upbound Cloud extension and an API definition. This API allows control planes to provision Azure AKS clusters, composed using cloud service primitives from the Upbound Official Providers
+
 spec:
   crossplane:
     version: ">=v1.14.1-0"