[Auto] [Update] Document expression syntax highlighting, layer property type, AI sub-agents, and other recent GDevelop changes (#698)

Author: github-actions[bot]

automated_updates_data.json

@@ -1,5 +1,5 @@
 {
-  "last_automated_updates_commit": "d52d42d3b4dd16f7cd57727fdd80f721fc0f6f80",
+  "last_automated_updates_commit": "8b00514aff34604e6488eb878c0f35610c5e6561",
   "last_improved_things": [
     {
       "date": "2026-02-16",

docs/gdevelop5/all-features/resources-loading/index.md

@@ -69,6 +69,8 @@ You can then use the **Preload object** and **Unload object** actions.
 
 ![](object-preload-action.png)
 
+These actions and the **Object preloaded** condition take a scene name as a parameter, so you can preload, unload or check objects defined in another scene (for example, preloading a level's objects from a menu scene).
+
 The **Preload object** action does not pause the game while the object's resources are being preloaded. If you try to create the object immediately, you will likely see "pink images" because some resources have not finished loading yet. To check when it is safe to create the object, use the **Object preloaded** condition.
 
 ![](object-preload-events.png)

docs/gdevelop5/behaviors/events-based-behaviors/index.md

@@ -137,6 +137,7 @@ Properties can be:
 * Numbers
 * Strings (including colors or string with choices)
 * Booleans (displayed as a checkbox)
+* Layers — to let extension users pick one of the scene's layers (useful when your behavior needs to act on a specific layer, like moving its camera)
 
 Properties can also be used to required behaviors as described in a following section.
 

docs/gdevelop5/events/expressions/index.md

@@ -20,6 +20,8 @@ These icons indicate that the field accepts an _expression_. An expression is a
 
     For a complete list of the function expressions that GDevelop provides out of the box, refer to [expressions reference](/gdevelop5/all-features/expressions-reference).
 
+Expressions written in the events sheet are colored to make them easier to read at a glance: numbers, strings, operators, object names, variables and boolean values each use a distinct color. This helps you quickly spot the structure of an expression and catch typos.
+
 <div class="video-container">
   <iframe src="https://www.youtube.com/embed/JNqekjjendk" frameborder="0" allowfullscreen></iframe>
 </div>

docs/gdevelop5/interface/ai/agent/index.md

@@ -85,4 +85,4 @@ Prioritizing the "[Ask](/gdevelop5/interface/ai/chat/)" mode over "Build" mode w
 
 This is why the only way to improve it is by rating the AI’s answers with a 👍 or 👎: positive ratings will signal the AI to follow that rationale. Negative feedback will nudge the GDevelop team that the answer wasn't correct.
 
-In the case of negative feedback, adding context to why the answer wasn't correct will help the engineers stir the AI to the right direction.
+In the case of negative feedback, adding context to why the answer wasn't correct will help the engineers stir the AI to the right direction.

docs/gdevelop5/interface/events-editor/index.md

@@ -109,6 +109,10 @@ You can change the colour of **comments** and **event group** by right-clicking
 
 ![](/gdevelop5/interface/events-editor/pasted/20230313-183427.png)
 
+## Select events
+
+You can select multiple events by holding **Shift** or **Ctrl** while clicking. To select every event in the current sheet at once, use **Select All** (available from the Edit menu and the command palette). Clicking on an already-selected event while a multi-selection is active will deselect that single event.
+
 ## Delete selected events
 
 By clicking the Delete selected events button, selected events will be removed from the event sheet, as well as any subevents. (you can also press the Delete key)

docs/gdevelop5/interface/preview.md

@@ -41,6 +41,8 @@ By default, the preview starts with the scene that you're currently editing. If
 
 A flag will be added to the icon to remind you that the preview is always starting from the chosen scene, even if you're editing another one. You can later remove this setting by using the same menu and deselecting the option.
 
+This setting is saved in the project file, so it is preserved when you reopen the project or share it with collaborators.
+
 ## Launch a Network preview (Preview over WiFi/LAN)
 
 By selecting **Network preview (Preview over WiFi/LAN)** from the drop-down menu beside the preview button, you can preview your game on mobile devices (or any other computer) connected to the same network as the editor.

docs/gdevelop5/interface/scene-editor/layers-and-cameras.md

@@ -108,6 +108,10 @@ There are also several [useful expressions](https://wiki.gdevelop.io/gdevelop5/a
 - CameraBorderLeft(layer, number)
 - CameraBorderRight(layer, number)
 
+### Moving layer cameras from a custom object
+
+Custom objects expose their own layers, which can be moved like scene layers using the same camera actions and expressions from inside the custom object's events. This is useful when a custom object embeds its own scrolling UI, minimap or framed view that should pan independently from the scene's camera.
+
 ## Reference
 
 All actions, conditions and expressions are listed in [layers and cameras reference page](/gdevelop5/all-features/layers-and-cameras/reference/).