From 94a277ef9d550804be1959f9fd9b003827960175 Mon Sep 17 00:00:00 2001
From: Serhii Snitsaruk <limbonaut@pm.me>
Date: Thu, 21 Mar 2024 15:16:27 +0100
Subject: [PATCH] Doc: Explain using `_var` suffix for var properties

---
 doc/source/getting-started/custom-tasks.rst     |  2 ++
 doc/source/getting-started/using-blackboard.rst | 10 ++++++++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/doc/source/getting-started/custom-tasks.rst b/doc/source/getting-started/custom-tasks.rst
index 75d2fae..4cbc7c8 100644
--- a/doc/source/getting-started/custom-tasks.rst
+++ b/doc/source/getting-started/custom-tasks.rst
@@ -20,6 +20,8 @@ More on task types you can read in the :ref:`introduction`.
    **🛈 Note:** To help you write new tasks, you can add a script template to
    your project using “Misc → Create script template” menu option.
 
+Using the :ref:`Blackboard<class_Blackboard>` is covered in :ref:`accessing_blackboard`.
+
 Task anatomy
 ------------
 
diff --git a/doc/source/getting-started/using-blackboard.rst b/doc/source/getting-started/using-blackboard.rst
index 8ffa205..445ea6d 100644
--- a/doc/source/getting-started/using-blackboard.rst
+++ b/doc/source/getting-started/using-blackboard.rst
@@ -10,6 +10,8 @@ including objects and resources.
 
 Using the :ref:`Blackboard<class_Blackboard>`, you can easily share data in your behavior trees, making the tasks in the behavior tree more flexible.
 
+.. _accessing_blackboard:
+
 Accessing the Blackboard in a Task
 ----------------------------------
 
@@ -31,9 +33,13 @@ Here's an example of how you can interact with the :ref:`Blackboard<class_Blackb
         # Check if the "speed" variable exists:
         if blackboard.has_var(speed_var):
             # ...
-..
 
-    **🛈 Note:** The variable doesn't need to exist when you set it.
+It is recommended to suffix variable name properties with ``_var``, like in the example above, which enables the
+inspector to provide a more convenient property editor for the variable. This editor
+allows you to select or add the variable to the blackboard plan, and provides a
+warning icon if the variable does not exist in the blackboard plan.
+
+    **🛈 Note:** The variable doesn't need to exist when you set it in code.
 
 .. _editing_plan: