add install directions

README.md

@@ -1,26 +1,12 @@
 # kapp-controller
 
 - Slack: [#k14s in Kubernetes slack](https://slack.kubernetes.io)
-- [Docs](docs/README.md) with topics about config, etc.
-- Install: see below section
+- [Docs](docs/README.md) with topics about installation, config, etc.
+- Install: see [Install instructions](docs/install.md)
 
 kapp controller provides a way to specify which applications should run on your K8s cluster. It will install, and continiously apply updates.
 
 Features:
 - supports fetching Helm charts (via `helm fetch`), git repos (via `git`), Docker images (via [imgpkg](https://github.com/k14s/imgpkg)), inline content within resource
 - supports templating of Helm charts, [ytt](https://get-ytt.io) configuration
 - installs and syncs resources with [kapp](https://get-kapp.io)
-
-## Development & Deploy
-
-Install ytt, kbld, kapp beforehand (https://k14s.io).
-
-```
-./hack/build.sh  # to build locally
-
-# add `-v image_repo=docker.io/username/kapp-controller` with your registry to ytt invocation inside
-./hack/deploy.sh # to deploy
-
-export KAPPCTRL_E2E_NAMESPACE=kappctrl-test
-./hack/test-all.sh
-```

docs/README.md

@@ -1,4 +1,5 @@
 ## Docs
 
+- [Install](install.md)
 - [Config](config.md)
-- [App spec](app-spec.md)
+- [App CRD spec](app-spec.md)

docs/dev.md

@@ -0,0 +1,13 @@
+## Development & Deploy
+
+Install ytt, kbld, kapp beforehand (https://k14s.io).
+
+```
+./hack/build.sh # to build locally
+
+# add `-v image_repo=docker.io/username/kapp-controller` with your registry to ytt invocation inside
+./hack/deploy.sh # to deploy
+
+export KAPPCTRL_E2E_NAMESPACE=kappctrl-test
+./hack/test-all.sh
+```

docs/install.md

@@ -0,0 +1,22 @@
+## Install
+
+Grab latest copy of YAML from the [Releases page](https://github.com/k14s/kapp-controller/releases) and use your favorite deployment tool (such as [kapp](https://get-kapp.io) or kubectl) to install it.
+
+Example:
+
+```bash
+$ kapp deploy -a kc -f https://github.com/k14s/kapp-controller/releases/download/v0.1.0/release.yml
+```
+
+Note: By default kapp controller allows to install any piece of Kubernetes configuration, hence `release.yml` includes ClusterRole that allows modification of all resources in the cluster. Limit them appropriately based on your needs.
+
+### Advanced
+
+`release.yml` is produced with [ytt](https://get-ytt.io) and [kbld](https://get-kbld.io) at the time of the release. You can use these tools yourself and customize kapp controller configuration if default one does not fit your needs.
+
+Example:
+
+```
+$ git clone ...
+$ kapp deploy -a kc -f <(ytt -f config/ | kbld -f-)
+```