Extend documentation (#30)

* Extend documentation

* typo

README.md

@@ -1,10 +1,35 @@
 # FIWARE Data Space Connector
 
-Connector bundling all components
+The FIWARE Data Space Connector is an integrated suite of components implementing DSBA Technical Convergence recommendations, every organization participating 
+in a data space should deploy to “connect” to a data space.
 
-## Deployment with Helm
+This repository provides the charts and deployment recipes. 
 
-Even thought a gitops-approach, following the app-of-apps pattern, with [ArgoCD](https://argo-cd.readthedocs.io/en/stable/), is the preferred way to deploy the Data-Space-Connector, not everyone has has it available. Therefor, the Data-Space-Connector is also provided as an [Umbrella-Chart](https://helm.sh/docs/howto/charts_tips_and_tricks/#complex-charts-with-many-dependencies), containing all the sub-charts and their dependencies.
+A more extensive documentation about the connector and the supported flows in a data space it supports can be found at the 
+FIWARE [data-space-connector repository](https://github.com/FIWARE/data-space-connector).
+
+
+
+## Deployment
+
+
+### Deployment with ArgoCD
+
+The FIWARE Data Space Connector is a [Helm](https://helm.sh) chart using a gitops-approach, following 
+the [app-of-apps pattern](https://argo-cd.readthedocs.io/en/stable/operator-manual/cluster-bootstrapping), with [ArgoCD](https://argo-cd.readthedocs.io/en/stable/). 
+
+This repository already provides a [deployment Github action](.github/workflows/deploy.yaml) compatible with OpenShift clusters, performing deployments out of 
+a branch created in the format `deploy/<TARGET_NAMESPACE>` and pulling the `values.yaml` from a specified gitops repository. It also requires to set the 
+following ENVs for the Github action, `OPENSHIFT_SERVER` and `OPENSHIFT_TOKEN`, specifying the OpenShift target URL and access token, respectively.  
+For deployment, simply fork this repository, adapt the configuration of the action to your setup and set the necessary ENVs. After creating a 
+`deploy/<TARGET_NAMESPACE>` branch, it will perform the deployment to the specified namespace.
+
+For a different cluster flavor, the GitHub action needs to be modified before to be compatible.
+
+
+### Deployment with Helm
+
+Even though a gitops-approach, following the app-of-apps pattern, with ArgoCD, is the preferred way to deploy the Data-Space-Connector, not everyone has it available. Therefore, the Data-Space-Connector is also provided as an [Umbrella-Chart](https://helm.sh/docs/howto/charts_tips_and_tricks/#complex-charts-with-many-dependencies), containing all the sub-charts and their dependencies.
 
 The chart is available at the repository ```https://fiware-ops.github.io/data-space-connector/```. You can install it via: