Merge pull request #6 from xrstf/helm-docs

add docs on how to use init-agent in an kcp-operator managed kcp

Author: kcp-ci-bot

docs/content/.pages

@@ -1,9 +1,9 @@
 nav:
   - Documentation:
       - README.md
-      - setup.md
       - readiness.md
       - faq.md
+  - Setup: setup
   - Init Sources: init-sources
   - Reference: reference
   - Contributing: contributing

docs/content/readiness.md

@@ -10,7 +10,7 @@ individual manifests.
 
 ## How It Works
 
-When the init-agent encounters a manifest (from any of its [init sources](./init-sources/)) with
+When the init-agent encounters a manifest (from any of its [init sources](init-sources/README.md)) with
 the `initialization.kcp.io/wait-for-ready` annotation, it will:
 
 1. Create (or confirm the existence of) the object as usual.

docs/content/setup/.pages

@@ -0,0 +1,4 @@
+nav:
+  - README.md
+  - development.md
+  - production.md

docs/content/setup/README.md

@@ -0,0 +1,10 @@
+# Setting up the Init Agent
+
+This chapter describes different methods of installing the init-agent.
+
+## Overview
+
+* [Development](development.md) is a quick-ish setup suitable for hacking and
+  quick tests.
+* [Production](production.md) is geared more towards a production environment,
+  managed by the kcp-operator.

docs/content/setup.md docs/content/setup/development.mddocs/content/setup.md renamed to docs/content/setup/development.md

@@ -1,4 +1,4 @@
-# Installing the Init Agent
+# Development Setup
 
 This page describes the necessary steps to setup the Init Agent for an existing [kcp][kcp] installation.
 
@@ -152,34 +152,6 @@ spec:
 
 ## Running the Agent
 
-For regular use, the init-agent should be installed using its [Helm chart][helmchart], but for
-debugging purposes it's also possible to run the agent locally.
-
-### Helm Chart
-
-To use the Helm chart, first add the repository to your local system:
-
-```bash
-helm repo add kcp https://kcp-dev.github.io/helm-charts
-helm repo update
-```
-
-At the very least you will have to provide
-
-* a kubeconfig to access kcp
-* the name of the workspace/cluster where the `InitTargets` and other resources
-  reside
-
-Put both in your `myvalues.yaml` (check the `values.yaml` for more examples).
-
-You can now install the chart:
-
-```bash
-helm upgrade --install my-init-agent kcp/init-agent --values ./myvalues.yaml
-```
-
-### Locally
-
 For development purposes you can run the agent directly. You can build your own from
 source or download one of the [ready-made releases][releases]. To run it, you need
 to provide the kcp kubeconfig and the workspace/cluster where the `InitTargets`