From b36dd7e4aa13bb913f6227e59a8c3b75253fa832 Mon Sep 17 00:00:00 2001
From: smix8 <52464204+smix8@users.noreply.github.com>
Date: Thu, 2 Jun 2022 01:24:43 +0200
Subject: [PATCH] Note that NavigationObstacles should only be used if
 necessary and for moving objects only

Note that NavigationObstacles should only be used if necessary and for moving objects only.

(cherry picked from commit d1959cabd9c9e3a7f1143d3ac7abdbff89eda5ed)
---
 doc/classes/NavigationObstacle.xml   | 1 +
 doc/classes/NavigationObstacle2D.xml | 1 +
 2 files changed, 2 insertions(+)

diff --git a/doc/classes/NavigationObstacle.xml b/doc/classes/NavigationObstacle.xml
index 33adcce4e..44852cfd6 100644
--- a/doc/classes/NavigationObstacle.xml
+++ b/doc/classes/NavigationObstacle.xml
@@ -5,6 +5,7 @@
 	</brief_description>
 	<description>
 		3D obstacle used in navigation for collision avoidance. The obstacle needs navigation data to work correctly. This can be done by having the obstacle as a child of a [Navigation] node, or using [method set_navigation]. [NavigationObstacle] is physics safe.
+		[b]Note:[/b] Obstacles are intended as a last resort option for constantly moving objects that cannot be (re)baked to a navigation mesh efficiently.
 	</description>
 	<tutorials>
 	</tutorials>
diff --git a/doc/classes/NavigationObstacle2D.xml b/doc/classes/NavigationObstacle2D.xml
index d6b03c854..f9a6456b4 100644
--- a/doc/classes/NavigationObstacle2D.xml
+++ b/doc/classes/NavigationObstacle2D.xml
@@ -5,6 +5,7 @@
 	</brief_description>
 	<description>
 		2D obstacle used in navigation for collision avoidance. The obstacle needs navigation data to work correctly. This can be done by having the obstacle as a child of a [Navigation2D] node, or using [method set_navigation]. [NavigationObstacle2D] is physics safe.
+		[b]Note:[/b] Obstacles are intended as a last resort option for constantly moving objects that cannot be (re)baked to a navigation mesh efficiently.
 	</description>
 	<tutorials>
 	</tutorials>