Merge pull request #1047 from grafana/refactor-docker-docs-a-bit

Refactor docker docs a bit

Author: Dieterbe

README.md

@@ -55,6 +55,7 @@ Otherwise data loss of current chunks will be incurred.  See [operations guide](
 
 * [Overview](https://github.com/grafana/metrictank/blob/master/docs/overview.md)
 * [Quick start using docker](https://github.com/grafana/metrictank/blob/master/docs/quick-start-docker.md)
+  ([other docker stacks](docs/docker.md))
 * [Installation guides](https://github.com/grafana/metrictank/blob/master/docs/installation.md)
 * [Configuration](https://github.com/grafana/metrictank/blob/master/docs/config.md)
 * [Memory server](https://github.com/grafana/metrictank/blob/master/docs/memory-server.md)

docs/CONTRIBUTING.md

@@ -44,6 +44,6 @@ see the [Makefile](../Makefile) for more targets
 
 # Documentation
 
-* [docs](../docs) for users and operators
-* [devdocs](../devdocs) for MT developers
+* [docs](../docs) for users, operators and basic development instructions
+* [devdocs](../devdocs) in-depth implementation details for developers
 

devdocs/docker.md docs/docker.md

@@ -17,6 +17,8 @@ plain, basic environment.
 uses metrictank docker image (with baked in binaries and configs), statsdaemon.
 Comes with 1 dashboard: the metrictank dashboard
 
+[see our quickstart guide](https://github.com/grafana/metrictank/blob/master/docs/quick-start-docker.md)
+
 ### docker-dev
 
 Similar to docker-standard, but custom metrictank build is loaded, custom configs from scripts/config
@@ -45,6 +47,8 @@ Similar to docker-dev-custom-cfg-kafka
 * uses a cluster of 4 MT's (with 2x replication)
 * separate graphite monitoring server
 
+[see our docker-cluster quickstart guide](https://github.com/grafana/metrictank/blob/master/docs/quick-start-docker-cluster.md)
+
 ### docker-chaos
 
 Similar to docker-cluster but used for chaos testing

docs/quick-start-docker-cluster.md

@@ -1,5 +1,9 @@
 # Quick start for docker-cluster
 
+The metrictank repository holds various stack configurations. See [docker](docker.md) for more info.
+If you're not familiar with Grafana dashboarding and datasources, you should first follow
+[our standard quickstart guide](https://github.com/grafana/metrictank/blob/master/docs/quick-start-docker.md) which goes further in depth on that.
+
 The docker-cluster image is similar to docker-standard, but with the following changes and features:
 
 * Cluster of 4 metrictanks (with 2x replication)
@@ -114,4 +118,4 @@ To clean up all data so you can start fresh, run this after you stopped the stac
 ```
 docker rm -v $(docker ps -a -q -f status=exited)
 ```
-This will remove the stopped containers and their data volumes.
+This will remove the stopped containers and their data volumes.

docs/quick-start-docker.md

@@ -171,4 +171,4 @@ This will remove the stopped containers and their data volumes.
 
 ## Other docker stacks
 
-The metrictank repository holds other stack configurations as well (for clustering, benchmarking, etc). See [devdocs/docker](../devdocs/docker.md) for more info.
+The metrictank repository holds other stack configurations as well (for clustering, benchmarking, etc). See [docker](docker.md) for more info.