Additional updates based on internal review

Author: JeanMarc van Leerdam

README.md

@@ -271,8 +271,8 @@ Output:
 
 > [!IMPORTANT]
 > As mentioned above, some elements support special shapes. However, when using special shapes, nesting is not always possible using the 
-> special shape. This applies to all `Service` elements, and the `Motivation_Value` element. If you have special shapes active, you have
-> to add a `$nest=%true()` parameter to these elements to avoid errors or unexpected results.
+> special shape. This applies to all `Service` elements, the `Motivation_Value` element, and the `Business_Actor` element. If you have
+> special shapes active, you have to add a `$nest=%true()` parameter to these elements to avoid errors or unexpected results.
 
 ### Theme Support
 Theme support is enabled and 5 variations are available. All the themes are based on Archimate specifications.

dist/plantuml-stdlib/stdlib/archimate/themes/shared_style.puml

@@ -42,8 +42,8 @@ skinparam lineType $ARCH_LINETYPE
 !global $ARCH_SHARP_CORNER ?= 1
 
 ' $ARCH_SPECIAL_SHAPES drives the usage of special shapes for some elements.
-' Note that we only use plantuml shapes that support nesting
-' This means that we do not use actor, queue (for role and stakeholder), or usecase (for value)
+' Note that there are some custom shapes that do not support nesting (actor and usecase).
+' This means that when using these elements as containers, one must add `$nest=%true()` to the call, so that the regular shape will be used.
 !global $ARCH_SPECIAL_SHAPES ?= %false()
 
 <style>

samples/Archimate-Elements.wsd

@@ -1,10 +1,10 @@
 @startuml
 '!pragma layout smetana
 
-!global $ARCH_LOCAL = true
-!global $ARCH_DEBUG = false
-!global $ARCH_SPECIAL_SHAPES = true
-!if ($ARCH_LOCAL == false)
+!global $ARCH_LOCAL = %false()
+!global $ARCH_DEBUG = %false()
+!global $ARCH_SPECIAL_SHAPES = %true()
+!if ($ARCH_LOCAL == %false())
     !include <archimate/Archimate>
     '!theme archimate-alternate from <archimate/themes>
     '!theme archimate-handwriting from <archimate/themes>