From 05ea1590828489f24ea147588bbee995bc50c08d Mon Sep 17 00:00:00 2001
From: Jess <53754871+jessover9000@users.noreply.github.com>
Date: Wed, 8 Apr 2020 13:03:48 +0200
Subject: [PATCH] Docs: Switch.mdx (#23142)

* Add "When to use" info to Switch.mdx

* Update Switch.mdx
---
 packages/grafana-ui/src/components/Forms/Switch.mdx | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/grafana-ui/src/components/Forms/Switch.mdx b/packages/grafana-ui/src/components/Forms/Switch.mdx
index 8d1b1a92a9c..1e1936a26cc 100644
--- a/packages/grafana-ui/src/components/Forms/Switch.mdx
+++ b/packages/grafana-ui/src/components/Forms/Switch.mdx
@@ -5,7 +5,12 @@ import { Switch } from "./Switch";
 
 # Switch
 
-Used to represent binary values
+### When to use
+
+`Switch` is a representation of an on-off state – like a light switch. So you can use `Switch` to toggle binary states.
+
+Switches trigger changes immediately. If your component should trigger a change only after sending a form, it's better to use either `RadioButtonGroup` or `Checkbox` instead. Furthermore, switches cannot be grouped – each `Switch` triggers an independent state. If you want multiple mutually exclusive choices, the `RadioButtonGroup` is the better option. To offer multiple choices within the same group or context which are not mutually exclusive, use `Checkbox` instead.
+
 
 ### Usage