From 89f05b5909d5c2a6d2139923d88c2e8ea8b335cb Mon Sep 17 00:00:00 2001
From: "alejandro.suarez@omron.com" <alejandro.suarez@omron.com>
Date: Thu, 6 Nov 2025 13:32:56 +0100
Subject: [PATCH] Fixed decorator image and text in BT basics

---
 docs/learn-the-basics/BT_basics.md            |   7 +-
 .../images/DecoratorEnterRoom.svg             | 211 ++++++++++--------
 2 files changed, 119 insertions(+), 99 deletions(-)

diff --git a/docs/learn-the-basics/BT_basics.md b/docs/learn-the-basics/BT_basics.md
index 5a92c69..19cd35e 100644
--- a/docs/learn-the-basics/BT_basics.md
+++ b/docs/learn-the-basics/BT_basics.md
@@ -122,9 +122,9 @@ this node could be either:
 
 The node __Inverter__ is a Decorator that inverts 
 the result returned by its child; an Inverter followed by the node called
-__isDoorClosed__ is, therefore, equivalent to 
+__isDoorOpen__ is, therefore, equivalent to 
 
-    "Is the door open?".
+    "Is the door closed?".
 
 The node __Retry__ will repeat ticking the child up to __num_attempts__ times (5 in this case)
 if the child returns FAILURE.
@@ -137,8 +137,9 @@ __Apparently__, the branch on the left side means:
 But...
     
 :::caution Find the BUG!
+The tree expects the door to be closed so it can attempt up to 5 times to open it.
 If __isDoorOpen__ returns FAILURE, we have the desired behavior.
-But if it returns SUCCESS, the left branch fails, and the entire Sequence
+But if it returns SUCCESS (i.e. the door is already open), the bottom-left branch fails, and the top-level Sequence
 is interrupted.
 :::
     
diff --git a/docs/learn-the-basics/images/DecoratorEnterRoom.svg b/docs/learn-the-basics/images/DecoratorEnterRoom.svg
index 0b7564b..9752d08 100644
--- a/docs/learn-the-basics/images/DecoratorEnterRoom.svg
+++ b/docs/learn-the-basics/images/DecoratorEnterRoom.svg
@@ -7,7 +7,7 @@
    version="1.1"
    viewBox="0 0 1798.08 948.96"
    sodipodi:docname="DecoratorEnterRoom.svg"
-   inkscape:version="1.1.2 (0a00cf5339, 2022-02-04)"
+   inkscape:version="1.3 (0e150ed6c4, 2023-07-21)"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns:xlink="http://www.w3.org/1999/xlink"
@@ -23,16 +23,15 @@
      inkscape:pagecheckerboard="0"
      inkscape:deskcolor="#d1d1d1"
      showgrid="false"
-     inkscape:zoom="0.65069409"
-     inkscape:cx="-120.64041"
-     inkscape:cy="1308.6026"
-     inkscape:window-width="2490"
-     inkscape:window-height="1376"
-     inkscape:window-x="1990"
-     inkscape:window-y="27"
+     inkscape:zoom="0.32534705"
+     inkscape:cx="1349.3284"
+     inkscape:cy="530.20306"
+     inkscape:window-width="1920"
+     inkscape:window-height="1009"
+     inkscape:window-x="1912"
+     inkscape:window-y="-8"
      inkscape:window-maximized="1"
-     inkscape:current-layer="text3171"
-     inkscape:pageshadow="2" />
+     inkscape:current-layer="svg398" />
   <defs
      id="defs130">
     <g
@@ -477,51 +476,6 @@
      stroke-width="4.25"
      d="M 493.501805 350.592277 L 1003.450892 350.592277 L 1003.450892 520.571832 L 493.501805 520.571832 Z M 493.501805 350.592277"
      transform="matrix(0.749791, 0, 0, 0.749791, 0, 0)" />
-  <g
-     id="g190"
-     fill="#000"
-     fill-opacity="1">
-    <use
-       id="use174"
-       x="453.997"
-       y="347.306"
-       xlink:href="#glyph-0-7" />
-    <use
-       id="use176"
-       x="489.031"
-       y="347.306"
-       xlink:href="#glyph-0-8" />
-    <use
-       id="use178"
-       x="520.928"
-       y="347.306"
-       xlink:href="#glyph-0-9" />
-    <use
-       id="use180"
-       x="533.67"
-       y="347.306"
-       xlink:href="#glyph-0-9" />
-    <use
-       id="use182"
-       x="546.412"
-       y="347.306"
-       xlink:href="#glyph-0-10" />
-    <use
-       id="use184"
-       x="578.309"
-       y="347.306"
-       xlink:href="#glyph-0-8" />
-    <use
-       id="use186"
-       x="610.206"
-       y="347.306"
-       xlink:href="#glyph-0-6" />
-    <use
-       id="use188"
-       x="638.883"
-       y="347.306"
-       xlink:href="#glyph-0-11" />
-  </g>
   <path
      id="path192"
      fill="#FFF"
@@ -673,47 +627,36 @@
      id="g266"
      fill="#000"
      fill-opacity="1">
-    <g
-       aria-label="IsDoorClosed"
-       id="text3171"
-       style="font-size:56px;stroke-width:0.75">
-      <path
-         d="m 73.850876,850.46045 h 5.523437 v 40.82422 h -5.523437 z"
-         id="path13777" />
-      <path
-         d="m 109.67119,861.56201 v 4.75781 q -2.13281,-1.09375 -4.42969,-1.64062 -2.29687,-0.54688 -4.75781,-0.54688 -3.746095,0 -5.632814,1.14844 -1.859375,1.14844 -1.859375,3.44531 0,1.75 1.339844,2.76172 1.339843,0.98438 5.386718,1.88672 l 1.722657,0.38281 q 5.35937,1.14844 7.60156,3.25391 2.26953,2.07813 2.26953,5.82422 0,4.26562 -3.39062,6.75391 -3.36328,2.48828 -9.269533,2.48828 -2.460937,0 -5.140625,-0.49219 -2.652344,-0.46484 -5.605469,-1.42188 v -5.19531 q 2.789063,1.44922 5.496094,2.1875 2.707031,0.71094 5.359375,0.71094 3.554688,0 5.468748,-1.20313 1.91406,-1.23046 1.91406,-3.44531 0,-2.05078 -1.39453,-3.14453 -1.36718,-1.09375 -6.042965,-2.10547 l -1.75,-0.41015 q -4.675782,-0.98438 -6.753907,-3.00782 -2.078125,-2.05078 -2.078125,-5.60547 0,-4.32031 3.0625,-6.67187 3.0625,-2.35156 8.695313,-2.35156 2.789064,0 5.250004,0.41015 2.46093,0.41016 4.53906,1.23047 z"
-         id="path13779" />
-      <path
-         d="m 125.06572,854.99951 v 31.7461 h 6.67187 q 8.44922,0 12.35938,-3.82813 3.9375,-3.82812 3.9375,-12.08594 0,-8.20312 -3.9375,-12.0039 -3.91016,-3.82813 -12.35938,-3.82813 z m -5.52344,-4.53906 h 11.34766 q 11.86719,0 17.41797,4.94922 5.55078,4.92187 5.55078,15.42187 0,10.55469 -5.57813,15.50391 -5.57812,4.94922 -17.39062,4.94922 h -11.34766 z"
-         id="path13781" />
-      <path
-         d="m 174.31181,864.18701 q -4.04687,0 -6.39843,3.17188 -2.35157,3.14453 -2.35157,8.64062 0,5.4961 2.32422,8.66797 2.35156,3.14453 6.42578,3.14453 4.01953,0 6.3711,-3.17187 2.35156,-3.17188 2.35156,-8.64063 0,-5.4414 -2.35156,-8.61328 -2.35157,-3.19922 -6.3711,-3.19922 z m 0,-4.26562 q 6.5625,0 10.3086,4.26562 3.74609,4.26563 3.74609,11.8125 0,7.51953 -3.74609,11.8125 -3.7461,4.26563 -10.3086,4.26563 -6.58984,0 -10.33593,-4.26563 -3.71875,-4.29297 -3.71875,-11.8125 0,-7.54687 3.71875,-11.8125 3.74609,-4.26562 10.33593,-4.26562 z"
-         id="path13783" />
-      <path
-         d="m 208.57353,864.18701 q -4.04687,0 -6.39844,3.17188 -2.35156,3.14453 -2.35156,8.64062 0,5.4961 2.32422,8.66797 2.35156,3.14453 6.42578,3.14453 4.01953,0 6.3711,-3.17187 2.35156,-3.17188 2.35156,-8.64063 0,-5.4414 -2.35156,-8.61328 -2.35157,-3.19922 -6.3711,-3.19922 z m 0,-4.26562 q 6.5625,0 10.3086,4.26562 3.74609,4.26563 3.74609,11.8125 0,7.51953 -3.74609,11.8125 -3.7461,4.26563 -10.3086,4.26563 -6.58984,0 -10.33594,-4.26563 -3.71875,-4.29297 -3.71875,-11.8125 0,-7.54687 3.71875,-11.8125 3.7461,-4.26562 10.33594,-4.26562 z"
-         id="path13785" />
-      <path
-         d="m 248.71416,865.36279 q -0.84766,-0.49218 -1.85938,-0.71093 -0.98437,-0.2461 -2.1875,-0.2461 -4.26562,0 -6.5625,2.78906 -2.26953,2.76172 -2.26953,7.95704 v 16.13281 h -5.05859 v -30.625 h 5.05859 v 4.75781 q 1.58594,-2.78906 4.12891,-4.12891 2.54297,-1.36718 6.17968,-1.36718 0.51954,0 1.14844,0.082 0.62891,0.0547 1.39453,0.1914 z"
-         id="path13787" />
-      <path
-         d="m 284.78056,853.60498 v 5.82422 q -2.78906,-2.59766 -5.96093,-3.88281 -3.14454,-1.28516 -6.69922,-1.28516 -7,0 -10.71875,4.29297 -3.71875,4.26562 -3.71875,12.35937 0,8.06641 3.71875,12.35938 3.71875,4.26562 10.71875,4.26562 3.55468,0 6.69922,-1.28515 3.17187,-1.28516 5.96093,-3.88281 v 5.76953 q -2.89843,1.96875 -6.15234,2.95312 -3.22656,0.98438 -6.83594,0.98438 -9.26953,0 -14.60156,-5.66016 -5.33203,-5.6875 -5.33203,-15.50391 0,-9.84375 5.33203,-15.5039 5.33203,-5.6875 14.60156,-5.6875 3.66406,0 6.89063,0.98437 3.2539,0.95703 6.09765,2.89844 z"
-         id="path13789" />
-      <path
-         d="m 293.09306,848.73779 h 5.03125 v 42.54688 h -5.03125 z"
-         id="path13791" />
-      <path
-         d="m 320.51884,864.18701 q -4.04687,0 -6.39843,3.17188 -2.35157,3.14453 -2.35157,8.64062 0,5.4961 2.32422,8.66797 2.35157,3.14453 6.42578,3.14453 4.01954,0 6.3711,-3.17187 2.35156,-3.17188 2.35156,-8.64063 0,-5.4414 -2.35156,-8.61328 -2.35156,-3.19922 -6.3711,-3.19922 z m 0,-4.26562 q 6.5625,0 10.3086,4.26562 3.74609,4.26563 3.74609,11.8125 0,7.51953 -3.74609,11.8125 -3.7461,4.26563 -10.3086,4.26563 -6.58984,0 -10.33593,-4.26563 -3.71875,-4.29297 -3.71875,-11.8125 0,-7.54687 3.71875,-11.8125 3.74609,-4.26562 10.33593,-4.26562 z"
-         id="path13793" />
-      <path
-         d="m 362.43681,861.56201 v 4.75781 q -2.13281,-1.09375 -4.42968,-1.64062 -2.29688,-0.54688 -4.75782,-0.54688 -3.74609,0 -5.63281,1.14844 -1.85937,1.14844 -1.85937,3.44531 0,1.75 1.33984,2.76172 1.33984,0.98438 5.38672,1.88672 l 1.72265,0.38281 q 5.35938,1.14844 7.60157,3.25391 2.26953,2.07813 2.26953,5.82422 0,4.26562 -3.39063,6.75391 -3.36328,2.48828 -9.26953,2.48828 -2.46094,0 -5.14062,-0.49219 -2.65235,-0.46484 -5.60547,-1.42188 v -5.19531 q 2.78906,1.44922 5.49609,2.1875 2.70703,0.71094 5.35938,0.71094 3.55468,0 5.46875,-1.20313 1.91406,-1.23046 1.91406,-3.44531 0,-2.05078 -1.39453,-3.14453 -1.36719,-1.09375 -6.04297,-2.10547 l -1.75,-0.41015 q -4.67578,-0.98438 -6.75391,-3.00782 -2.07812,-2.05078 -2.07812,-5.60547 0,-4.32031 3.0625,-6.67187 3.0625,-2.35156 8.69531,-2.35156 2.78906,0 5.25,0.41015 2.46094,0.41016 4.53906,1.23047 z"
-         id="path13795" />
-      <path
-         d="m 398.28447,874.71436 v 2.46093 h -23.13281 q 0.32812,5.19532 3.11718,7.92969 2.81641,2.70703 7.82032,2.70703 2.89843,0 5.60547,-0.71094 2.73437,-0.71093 5.41406,-2.13281 v 4.75781 q -2.70703,1.14844 -5.55078,1.75 -2.84375,0.60157 -5.76953,0.60157 -7.32813,0 -11.6211,-4.26563 -4.26562,-4.26562 -4.26562,-11.53906 0,-7.51953 4.04687,-11.92188 4.07422,-4.42968 10.96485,-4.42968 6.17968,0 9.76171,3.99218 3.60938,3.96485 3.60938,10.80079 z m -5.03125,-1.47657 q -0.0547,-4.1289 -2.32422,-6.58984 -2.24219,-2.46094 -5.96094,-2.46094 -4.21093,0 -6.7539,2.37891 -2.51563,2.3789 -2.89844,6.69922 z"
-         id="path13797" />
-      <path
-         d="m 426.69463,865.30811 v -16.57032 h 5.03125 v 42.54688 h -5.03125 v -4.59375 q -1.58594,2.73437 -4.01954,4.07422 -2.40625,1.3125 -5.79687,1.3125 -5.55078,0 -9.05078,-4.42969 -3.47266,-4.42969 -3.47266,-11.64844 0,-7.21875 3.47266,-11.64844 3.5,-4.42968 9.05078,-4.42968 3.39062,0 5.79687,1.33984 2.4336,1.3125 4.01954,4.04688 z m -17.14454,10.6914 q 0,5.55078 2.26954,8.72266 2.29687,3.14453 6.28906,3.14453 3.99219,0 6.28906,-3.14453 2.29688,-3.17188 2.29688,-8.72266 0,-5.55078 -2.29688,-8.69531 -2.29687,-3.17188 -6.28906,-3.17188 -3.99219,0 -6.28906,3.17188 -2.26954,3.14453 -2.26954,8.69531 z"
-         id="path13799" />
-    </g>
+    <use
+       id="use242"
+       x="74.778"
+       y="892.162"
+       xlink:href="#glyph-0-21" />
+    <use
+       id="use244"
+       x="90.713"
+       y="892.162"
+       xlink:href="#glyph-0-19" />
+    <use
+       id="use246"
+       x="119.39"
+       y="892.162"
+       xlink:href="#glyph-0-20" />
+    <use
+       id="use248"
+       x="160.808"
+       y="892.162"
+       xlink:href="#glyph-0-16" />
+    <use
+       id="use250"
+       x="192.705"
+       y="892.162"
+       xlink:href="#glyph-0-16" />
+    <use
+       id="use252"
+       x="224.603"
+       y="892.162"
+       xlink:href="#glyph-0-14" />
   </g>
   <path
      id="path268"
@@ -1010,6 +953,82 @@
        y="892.162"
        xlink:href="#glyph-0-14" />
   </g>
+  <g
+     id="g372-3"
+     fill="#000000"
+     fill-opacity="1"
+     transform="translate(-511.36057,-1.3237927)">
+    <use
+       id="use356-6"
+       x="756.64502"
+       y="892.16199"
+       xlink:href="#glyph-0-27"
+       transform="translate(1.8175332,1.4645426)" />
+    <use
+       id="use358-7"
+       x="801.25598"
+       y="892.16199"
+       xlink:href="#glyph-0-28"
+       transform="translate(1.8175332,1.4645426)" />
+    <use
+       id="use360-5"
+       x="833.15399"
+       y="892.16199"
+       xlink:href="#glyph-0-2"
+       transform="translate(1.8175332,1.4645426)" />
+    <use
+       id="use362-3"
+       x="865.05103"
+       y="892.16199"
+       xlink:href="#glyph-0-5"
+       transform="translate(1.8175332,1.4645426)" />
+  </g>
+  <g
+     id="g162-5"
+     fill="#000000"
+     fill-opacity="1"
+     transform="translate(-510.77584,249.96784)">
+    <use
+       id="use146-0"
+       x="941.40002"
+       y="92.403"
+       xlink:href="#glyph-0-1" />
+    <use
+       id="use148-4"
+       x="979.65503"
+       y="92.403"
+       xlink:href="#glyph-0-2" />
+    <use
+       id="use150-6"
+       x="1011.552"
+       y="92.403"
+       xlink:href="#glyph-0-3" />
+    <use
+       id="use152-7"
+       x="1043.449"
+       y="92.403"
+       xlink:href="#glyph-0-4" />
+    <use
+       id="use154-7"
+       x="1075.3459"
+       y="92.403"
+       xlink:href="#glyph-0-2" />
+    <use
+       id="use156-6"
+       x="1107.243"
+       y="92.403"
+       xlink:href="#glyph-0-5" />
+    <use
+       id="use158-2"
+       x="1139.14"
+       y="92.403"
+       xlink:href="#glyph-0-6" />
+    <use
+       id="use160-8"
+       x="1167.817"
+       y="92.403"
+       xlink:href="#glyph-0-2" />
+  </g>
   <path
      id="path374"
      fill="none"