Write a proper Quick Start and improve Introduction

Author: metalmatze

Makefile

@@ -12,4 +12,4 @@ theme:
 
 .PHONY: public
 public:
-	hugo
+	hugo

content/docs/prologue/introduction.md

@@ -24,13 +24,16 @@ The Prometheus operator includes, but is not limited to, the following features:
 
 ## Get started
 
-There are two main ways to get started with Doks:
+<!-- There are two main ways to get started with Doks: -->
 
 ### Tutorial
 
 {{< alert icon="👉" text="The Tutorial is intended for novice to intermediate users." >}}
 
-Step-by-step instructions on how to start a new Doks project. [Tutorial →](https://getdoks.org/tutorial/introduction/)
+We still need to write you a proper tutorial...  
+Feel free to [comment on the opened issue](https://github.com/prometheus-operator/website/issues/3) if you want to help!
+
+<!-- Step-by-step instructions on how to start a new Doks project. [Tutorial →](https://getdoks.org/tutorial/introduction/) -->
 
 ### Quick Start
 
@@ -46,6 +49,9 @@ Recipes, Reference Guides, Extensions, and Showcase.
 
 Find out how to contribute to Doks. [Contributing →]({{< ref "contributing" >}})
 
-## Help
+## Support
+
+We have [GitHub Discussions](https://github.com/prometheus-operator/kube-prometheus/discussions) for kube-prometheus.
+We recommend asking questions there, as this is searchable compared to Slack.
 
-Get help on Doks.
+We're happy to talk to you on the [Kubernetes Slack](http://slack.k8s.io/) in #prometheus-operator!

content/docs/prologue/quick-start.md

@@ -1,9 +1,8 @@
 ---
 title: "Quick Start"
-description: "One page summary of how to start a new Doks project."
-lead: "One page summary of how to start a new Doks project."
+description: "One page summary of how to start with the Prometheus Operator and kube-prometheus."
+lead: "One page summary of how to start with the Prometheus Operator and kube-prometheus."
 date: 2020-11-16T13:59:39+01:00
-lastmod: 2020-11-16T13:59:39+01:00
 draft: false
 images: []
 menu:
@@ -15,42 +14,90 @@ toc: true
 
 ## Requirements
 
-Doks uses npm to install dependencies and run commands. Installing npm is pretty simple. Download and install [Node.js](https://nodejs.org/) (it includes npm) for your platform.
+The easiest way of starting with the Prometheus Operator is by deploying it as part of kube-prometheus.  
+kube-prometheus deploys the Prometheus Operator and already schedules a Prometheus called `prometheus-k8s` with alerts and rules by default.
 
-## Start a new Doks project
+All you need is access to a **Kubernetes cluster with kubectl!**
 
-Create a new site, change directories, install dependencies, and start development server.
+<!-- TODO: Reference the deploy kube-prometheus to kind tutorial once available  -->
 
-### Create a new site
+> Note: For versions before Kubernetes v1.20.z refer to the [Kubernetes compatibility matrix](https://github.com/prometheus-operator/kube-prometheus#kubernetes-compatibility-matrix) in order to choose a compatible branch.
 
-{{< btn-copy text="git clone https://github.com/h-enk/doks.git my-doks-site" >}}
+## Get the kube-prometheus project
 
-```bash
-git clone https://github.com/h-enk/doks.git my-doks-site
+For a quick start we are going to deploy a cmopiled version of the Kubernetes [manifests](https://github.com/prometheus-operator/kube-prometheus/tree/main/manifests).
+
+You can either clone the kube-prometheus from GitHub
+
+```shell
+git clone https://github.com/prometheus-operator/kube-prometheus.git
 ```
 
-### Change directories
+or download the current main branch as zip file and extract its contents:
+
+[github.com/prometheus-operator/kube-prometheus/archive/main.zip](https://github.com/prometheus-operator/kube-prometheus/archive/main.zip)
 
-{{< btn-copy text="cd my-doks-site" >}}
+Once you have the files on your machine change into the project's root directory.
 
-```bash
-cd my-doks-site
+## Deploy kube-prometheus
+
+```shell
+# Create the namespace and CRDs, and then wait for them to be availble before creating the remaining resources
+kubectl create -f manifests/setup
+until kubectl get servicemonitors --all-namespaces ; do date; sleep 1; echo ""; done
+kubectl create -f manifests/
 ```
 
-### Install dependencies
+We create the namespace and CustomResourceDefinitions first to avoid race conditions when deploying the monitoring components.
+Alternatively, the resources in both folders can be applied with a single command `kubectl create -f manifests/setup -f manifests`,
+but it may be necessary to run the command multiple times for all components to be created successfullly.
+
+## Access Prometheus
 
-{{< btn-copy text="npm install" >}}
+Prometheus, Alertmanager, and Grafana dashboards can be accessed quickly using `kubectl port-forward` after running the quickstart via the commands below.
 
-```bash
-npm install
+You can also learn how to [expose via an Ingress →]({{< ref "docs/exposing-prometheus-alertmanager-grafana-ingress" >}})
+
+```shell
+kubectl --namespace monitoring port-forward svc/alertmanager-k8s 9090
 ```
 
-### Start development server
+Open Prometheus on [localhost:9090](http://localhost:9090) in your browser.
+
+Check out the [alerts](http://localhost:9090/alerts) and [rules](http://localhost:9090/rules) pages with the pre-configured rules and alerts!  
+This Prometheus is supposed to monitor your Kubernetes cluster and make sure to alert you if there's a problem with it.
+
+For your own applications we recommend running one or more other instances.
+<!-- TODO: Write a tutorial/doc on self service aspcects of Prometheus Operator -->
 
-{{< btn-copy text="npm run start" >}}
+## Access Alertmanager
 
-```bash
-npm run start
+```shell
+kubectl --namespace monitoring port-forward svc/alertmanager-main 9093
 ```
 
-Doks will start the Hugo development webserver accessible by default at `http://localhost:1313`. Saved changes will live reload in the browser.
+Open Alertmanager on [localhost:9093](http://localhost:9093) in your browser.
+
+<!-- TODO: Link to a document describing how to configure Alertmanager -->
+
+## Access Grafana
+
+```shell
+kubectl --namespace monitoring port-forward svc/grafana 3000
+```
+
+Open Grafana on [localhost:3000](http://localhost:3000) in your browser.   
+You can login with the username `admin` and password `admin`.
+
+## Remove kube-prometheus 
+
+If you're down experimenting with kube-prometheus and the Prometheus Operator you can simply teardown the deployment by running:
+```shell
+kubectl delete --ignore-not-found=true -f manifests/ -f manifests/setup
+```
+
+## Next Steps
+
+kube-prometheus is developerd as a library.  
+The idea is that you get a Kubernetes cluster monitoring stack and additionally you can add more Prometheus servers.
+