diff --git a/README.md b/README.md
index 0041e5b..cf2819c 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,19 @@
 # CI/CD Pipeline for Goghvideo application
+This repository contains the helm charts to mange and deploy the Tekton CI/CD pipeline for building, testing and promoting changes to the microservices to production.
+
+<ol>
+  <li>The eventlistener receives webhooks from gitea and validates the event using the gitea interceptor module and parameters defined in the triggerbinding</li>
+  <li>Using the triggertemplate, a job run is created based on the pipeline template</li>
+  <li>The pipeline executes a number of steps, including:
+    <ul>
+      <li>Setting a Pending state on the Gitea pull request</li>
+      <li>Cloning the repo and calculating a semver for the application build</li>
+      <li>Linting the application code (future test could include integration with static scanning engines, code coverage, unit testing, etc)</li>
+      <li>Compiling the application and building container images</li>
+      <li>Preparing an ephemeral namespace with localized RabbitMQ, application under test and deploying release versions of additional service components</li>
+      <li>Performing an end-to-end test, including dropping a test file, validatation of successful converstion and response from Twilio on successful notification event<li>
+      <li>Updating PR status-check with success/failure status<li>
+      <li>Merge branch into main<li>
+      <li>Updating production helm charts with new image tag and triggering an ArgoCD sync<li>
+    </ul>
+<ol>
\ No newline at end of file