From 1ed08d39c024745335836d5bde4eb3144be99b1c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Markus=20Th=C3=B6mmes?= <markusthoemmes@me.com>
Date: Wed, 30 Sep 2020 09:18:29 +0200
Subject: [PATCH] Add global configuration for target-burst-capacity and some
 corrections (#2871)

* Add global configuration for target-burst-capacity

* Correct some of the information
---
 .../autoscaling/target-burst-capacity.md      | 34 +++++++++++++++----
 1 file changed, 28 insertions(+), 6 deletions(-)

diff --git a/docs/serving/autoscaling/target-burst-capacity.md b/docs/serving/autoscaling/target-burst-capacity.md
index 4acc56c09..a969ae220 100644
--- a/docs/serving/autoscaling/target-burst-capacity.md
+++ b/docs/serving/autoscaling/target-burst-capacity.md
@@ -15,14 +15,14 @@ Target burst capacity can be configured using a combination of the following par
 
 * Setting the targeted concurrency limits for the revision. For more information, see the documentation on [concurrency](./concurrency.md).
 * Setting the target utilization parameters. For more information, see the documentation on [target utilization](./concurrency.md#target-utilization).
-* Setting the target burst capacity per revision.
+* Setting the target burst capacity.
 
-## Setting the target burst capacity per revision
+## Setting the target burst capacity
 
-* **Global key:** No global key.
+* **Global key:** `target-burst-capacity`
 * **Per-revision annotation key:** `autoscaling.knative.dev/targetBurstCapacity`
-* **Possible values:** float
-* **Default:** `70`
+* **Possible values:** float (`0` means the Activator is only in path when scaled to 0, `-1` means the Activator is always in path)
+* **Default:** `200`
 
 **Note:** If the activator is in the routing path, it will fully load all replicas up to `containerConcurrency`. It currently applies target utilization only on revision level.
 
@@ -40,8 +40,30 @@ spec:
   template:
     metadata:
       annotations:
-        autoscaling.knative.dev/minScale: "2"
         autoscaling.knative.dev/targetBurstCapacity: "70"
 ```
 {{< /tab >}}
+{{% tab name="Global (ConfigMap)" %}}
+```yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: config-autoscaler
+  namespace: knative-serving
+data:
+  target-burst-capacity: "70"
+```
+{{< /tab >}}
+{{% tab name="Global (Operator)" %}}
+```yaml
+apiVersion: operator.knative.dev/v1alpha1
+kind: KnativeServing
+metadata:
+  name: knative-serving
+spec:
+  config:
+    autoscaler:
+      target-burst-capacity: "70"
+```
+{{< /tab >}}
 {{< /tabs >}}