Add docs intro

cmd/tk/bootstrap_gitlab.go

@@ -18,7 +18,7 @@ var bootstrapGitLabCmd = &cobra.Command{
 	Use:   "gitlab",
 	Short: "Bootstrap GitLab repository",
 	Long: `
-The bootstrap command creates the GitHub repository if it doesn't exists and
+The bootstrap command creates the GitLab repository if it doesn't exists and
 commits the toolkit components manifests to the master branch.
 Then it configure the target cluster to synchronize with the repository.
 If the toolkit components are present on the cluster,

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).

mkdocs.yml

@@ -35,8 +35,9 @@ markdown_extensions:
   - pymdownx.tabbed
 
 nav:
+  - Introduction: index.md
   - Get Started: get-started/index.md
-  - tk CLI:
+  - Toolkit CLI:
     - Bootstrap: cmd/tk_bootstrap.md
     - Check: cmd/tk_check.md
     - Create: cmd/tk_create.md