Add docs intro

docs/get-started/index.md

@@ -19,11 +19,10 @@ that can create repositories.
 To install the latest `tk` release run:
 
 ```bash
-curl -s https:/fluxcd.github.io/toolkit/install.sh | sudo bash
+curl -s https://toolkit.fluxcd.io/install.sh | sudo bash
 ```
 
 The install script downloads the tk binary to `/usr/local/bin`.
-
 Binaries for macOS and Linux AMD64 are available for download on the 
 [release page](https://github.com/fluxcd/toolkit/releases).
 
@@ -36,22 +35,23 @@ To configure your shell to load tk completions add to your bash profile:
 
 ## Bootstrap 
 
-Export your GitHub personal access token with:
+You'll be using a dedicated Git repository e.g. `fleet-infra` to manage one or more Kubernetes clusters.
+
+First export your GitHub personal access token and GitHub username:
 
 ```sh
 export GITHUB_TOKEN=<your-token>
+export GITHUB_USER=<your-username>
 ```
 
-The bootstrap command creates a GitHub repository if one doesn't exist and
-commits the toolkit components manifests to the master branch.
-Then it configures the target cluster to synchronize with the repository.
-If the toolkit components are present on the cluster,
-the bootstrap command will perform an upgrade if needed.
+The bootstrap command creates a repository if one doesn't exist and
+commits the toolkit components manifests to the master branch at the specified path.
+Then it configures the target cluster to synchronize with the specified path inside the repository.
 
 ```sh
 tk bootstrap github \
-  --owner=<your-github-username> \
-  --repository=<repo-name> \
+  --owner=$GITHUB_USER \
+  --repository=fleet-infra \
   --path=dev-cluster \
   --personal
 ```
@@ -107,6 +107,10 @@ deployment "kustomize-controller" successfully rolled out
 
 If you prefer GitLab, export `GITLAB_TOKEN` env var and use the command `tk bootstrap gitlab`.
 
+It is safe to run the bootstrap command as many times as you want.
+If the toolkit components are present on the cluster,
+the bootstrap command will perform an upgrade if needed.
+
 ## Create a GitOps workflow
 
 Clone the repository with:

docs/index.md

@@ -1,5 +1,20 @@
 # GitOps Toolkit
 
-Experimental toolkit for assembling CD pipelines the GitOps way.
+The GitOps Toolkit is a set of composable APIs and specialized tools
+that can be used to build a Continuous Delivery platform on top of Kubernetes.
+
+These tools are built with Kubernetes controller-runtime libraries and they
+can be dynamically configured with Kubernetes custom resources either by
+cluster admins or by other automated tools.
+The GitOps Toolkit components interact with each other via Kubernetes
+events and are responsible for the reconciliation of their designated API objects. 
 
 ![](diagrams/tk-overview.png)
+
+Components:
+
+- [Toolkit CLI](https://github.com/fluxcd/toolkit)
+- [Source Controller](https://github.com/fluxcd/source-controller)
+- [Kustomize Controller](https://github.com/fluxcd/kustomize-controller)
+
+To get started with the toolkit please follow this [guide](get-started/index.md).