Read me & Description update

README.md

@@ -1,4 +1,39 @@
-# Application Configuration
+# Example App Configuration
 
-Application Configuration is reusable Configuration that can be used accross
-different reference platforms
+
+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 Ghost blog as an example of how to deploy apps.
+
+## 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 App API contains:
+
+- **an [App definition](/apis/definition.yaml) custom resource type.**
+- **Composition of the [app] resources:** Configured in [/apis/composition.yaml](/apis/composition.yaml), it provisions a Ghost blog deployment with helm and 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-app
+spec:
+  package: xpkg.upbound.io/upbound/configuration-app:v0.2.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.

crossplane.yaml

@@ -6,6 +6,13 @@ metadata:
     meta.crossplane.io/maintainer: Upbound <[email protected]>
     meta.crossplane.io/source: github.com/upbound/configuration-app
     meta.crossplane.io/license: Apache-2.0
+    meta.crossplane.io/description: |
+      This repository provides a foundational configuration to build and operate a Ghost blogging application, including handling its dependencies and configurations. The setup ensures a streamlined and repeatable deployment in a cloud environment.
+
+    meta.crossplane.io/readme: |
+     This repository offers a specialized configuration for deploying and managing the Ghost blogging application on Kubernetes using Crossplane. This setup provides the necessary infrastructure to deploy Ghost with with helm and managed with Crossplane in Kubernetes. This approach ensures a flexible, streamlined deployment to any cloud provider.
+
+     For more details and customization options, you can explore [the GitHub repository](https://github.com/upbound/configuration-app).
 spec:
   crossplane:
     version: ">=v1.14.1-0"