Mark Heapster as retired
As per the Heapster deprecation timeline, it's now time to retire
Heapster (since Kubernetes 1.13 is nigh).
# Heapster
-***DEPRECATED***: Heapster is deprecated. Consider using [metrics-server](https://github.com/kubernetes-incubator/metrics-server)
-and a third party metrics pipeline to gather Prometheus-format metrics instead. See the [deprecation timeline](docs/deprecation.md)
-for more information on support. We will not be adding any new features to Heapster.
+***RETIRED***: Heapster is now retired. See the [deprecation timeline](docs/deprecation.md)
+for more information on support. We will not be making changes to Heapster.
+
+The following are potential migration paths for Heapster functionality:
+
+- **For basic CPU/memory HPA metrics**: Use [metrics-server](https://github.com/kubernetes-incubator/metrics-server).
+
+- **For general monitoring**: Consider a third-party monitoring pipeline that can gather Prometheus-formatted metrics.
+ The kubelet exposes all the metrics exported by Heapster in Prometheus format.
+ One such monitoring pipeline can be set up using the [Prometheus Operator](https://github.com/coreos/prometheus-operator), which
+ deploys Prometheus itself for this purpose.
+
+- **For event transfer**: Several third-party tools exist to transfer/archive Kubernetes events, depending on your sink.
+ [heptiolabs/eventrouter](https://github.com/heptiolabs/eventrouter) has been suggested as a general alternative.
[![GoDoc](https://godoc.org/k8s.io/heapster?status.svg)](https://godoc.org/k8s.io/heapster) [![Build Status](https://travis-ci.org/kubernetes/heapster.svg?branch=master)](https://travis-ci.org/kubernetes/heapster) [![Go Report Card](https://goreportcard.com/badge/github.com/kubernetes/heapster)](https://goreportcard.com/report/github.com/kubernetes/heapster)
