From 9171737e2b240ec8cc66e9521cfa07bf947e3112 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Sun, 19 Jan 2020 14:28:39 +0100
Subject: [PATCH] Document Light contact shadows often looking broken

---
 doc/classes/Light.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/classes/Light.xml b/doc/classes/Light.xml
index f411a618cb3..00bdeee89c3 100644
--- a/doc/classes/Light.xml
+++ b/doc/classes/Light.xml
@@ -62,7 +62,8 @@
 			The color of shadows cast by this light.
 		</member>
 		<member name="shadow_contact" type="float" setter="set_param" getter="get_param" default="0.0">
-			Attempts to reduce [member shadow_bias] gap.
+			Attempts to reduce [member shadow_bias] gap by rendering screen-space contact shadows. This has a performance impact, especially at higher values.
+			[b]Note:[/b] Contact shadows can look broken, so leaving this property to [code]0.0[/code] is recommended.
 		</member>
 		<member name="shadow_enabled" type="bool" setter="set_shadow" getter="has_shadow" default="false">
 			If [code]true[/code], the light will cast shadows.