Move content to correct sections for generated summary

Signed-off-by: Danil Grigorev <[email protected]>

Author: Danil-Grigorev

docs/book/src/introduction.md renamed to docs/book/src/00_introduction.md

@@ -0,0 +1,3 @@
+# User guide
+
+This section contains quick start and concepts relevant to a new operator user.

docs/book/src/01_user/00.md

@@ -2,6 +2,8 @@
 
 This is a quickstart guide for getting Cluster API Operator up and running on your Kubernetes cluster.
 
+For more detailed information, please refer to the full documentation.
+
 ## Prerequisites
 
 - [Running Kubernetes cluster](https://cluster-api.sigs.k8s.io/user/quick-start#install-andor-configure-a-kubernetes-cluster).
@@ -25,42 +27,47 @@ kubectl create secret generic "${CREDENTIALS_SECRET_NAME}" --from-literal=AWS_B6
 
 ### Installing Cluster API Operator
 
-#### Method 1: Apply Manifests from Release Assets
-
-Before installing the Cluster API Operator this way, you must first ensure that cert-manager is installed, as the operator does not manage cert-manager installations. To install cert-manager, run the following command:
-
-```bash
-kubectl apply -f https://github.com/jetstack/cert-manager/releases/latest/download/cert-manager.yaml
-```
-
-Wait for cert-manager to be ready before proceeding.
-
-After cert-manager is successfully installed, you can install the Cluster API operator directly by applying the latest release assets:
+Add helm repository:
 
 ```bash
-kubectl apply -f https://github.com/kubernetes-sigs/cluster-api-operator/releases/latest/download/operator-components.yaml
+helm repo add capi-operator https://kubernetes-sigs.github.io/cluster-api-operator
+helm repo update
 ```
 
-#### Method 2: Use Helm Charts
-
-Alternatively, you can install the Cluster API operator using Helm charts:
+Deploy Cluster API components with docker provider using a single command during operator installation
 
 ```bash
-helm repo add capi-operator https://kubernetes-sigs.github.io/cluster-api-operator
-helm repo update
-helm install capi-operator capi-operator/cluster-api-operator --create-namespace -n capi-operator-system
+helm install capi-operator capi-operator/cluster-api-operator --create-namespace -n capi-operator-system --set infrastructure=docker --set cert-manager.enabled=true --set configSecret.name=${CREDENTIALS_SECRET_NAME} --set configSecret.namespace=${CREDENTIALS_SECRET_NAMESPACE}  --wait --timeout 90s
 ```
 
-##### Installing cert-manager using Helm chart
+Docker provider can be replaced by any provider supported by [clusterctl](https://cluster-api.sigs.k8s.io/reference/providers.html#infrastructure).
 
-CAPI operator Helm chart supports provisioning of cert-manager as a dependency. It is disabled by default, but you can enable it with `--set cert-manager.enabled=true` option to `helm install` command or inside of `cert-manager` section in [values.yaml](https://github.com/kubernetes-sigs/cluster-api-operator/blob/main/hack/charts/cluster-api-operator/values.yaml) file. Additionally you can define other [parameters](https://artifacthub.io/packages/helm/cert-manager/cert-manager#configuration) provided by the cert-manager chart.
+Other options for installing Cluster API Operator are described in [installation documentation](../02_installation/).
+ 
+# Example API Usage
 
-##### Installing providers using Helm chart
+Deploy latest version of core Cluster API components:
 
-Deploy Cluster API components with docker provider using a single command during operator installation:
+```yaml
+apiVersion: operator.cluster.x-k8s.io/v1alpha2
+kind: CoreProvider
+metadata:
+  name: cluster-api
+  namespace: capi-system
 
-```bash
-helm install capi-operator capi-operator/cluster-api-operator --create-namespace -n capi-operator-system --set infrastructure=docker --set cert-manager.enabled=true --set configSecret.name=${CREDENTIALS_SECRET_NAME} --set configSecret.namespace=${CREDENTIALS_SECRET_NAMESPACE}  --wait --timeout 90s
 ```
 
-Docker provider can be replaced by any provider supported by [clusterctl](https://cluster-api.sigs.k8s.io/reference/providers.html#infrastructure).
+Deploy Cluster API AWS provider with specific version, custom manager options and flags:
+
+```yaml
+---
+apiVersion: operator.cluster.x-k8s.io/v1alpha2
+kind: InfrastructureProvider
+metadata:
+ name: aws
+ namespace: capa-system
+spec:
+ version: v2.1.4
+ configSecret:
+   name: aws-variables
+```

docs/book/src/user/concepts.md renamed to docs/book/src/01_user/01_concepts.md

@@ -0,0 +1,7 @@
+# Cluster API Provider Lifecycle
+
+This section contains lifecycle operations a user can perform on a provider manifest, such as:
+- Install
+- Upgrade
+- Modify
+- Delete