[Auto] [Update] Document For Each event ordering by expression with optional limit

[github-actions]

This PR was automatically generated by the Update docs from GDevelop commits workflow.

An AI coding agent analysed recent commits in 4ian/GDevelop
and updated the documentation to reflect user-facing changes.

GDevelop commits covered

8559cf5b8 Improve events search UI with Match Case/Filters icon
eac6784de Fix npm commands not working with projects on a different disk on Windows (#8345)
c4cca8e34 Rename "any order" to "default order" for For Each events
3e14992de Fix For Each rendering when disabled and default values
48ee32503 Persist properties panel scroll position for instances and objects (#8337)
39a172dfe Allow multiple deletions in a single operation for generated events
283073808 Fix event generation errors not properly reported
2cf203e4d Tweak the delay before moving an object with gizmo in the 3D editor
737153773 Fix to avoid objects to move when the gizmo dragging point is clicked (#8334)
1d1c11bfa Explain the difference between built-in and external extensions in the documentation (#8335)
50353ab67 Allow to import asset pack files (GDO) (#8296)
19901da89 Fix Scene Editor panels not resizing as small as possible (#8331)
ca3980941 Fix brackets showing in the top right corner of the scene editor (#8332)
0fd041a70 Add storybook stories for Anchor behavior editors (#8330)
dd7fd4479 Fix new group name to ensure no usage of forbidden characters (#8329)
52486477b [Auto PR] Update translations (#8328)
dc4a7a1f9 Fix size calculation for variants
f12c9da28 Bump newIDE version
49fcdf2ec [Auto PR] Update translations (#8323)
cf3545cfc Add a simplified version of the Anchor behavior editor (#8325)
ff4256a0f Improve details of center/origin when an object is created by the AI (#8322)
73be609b9 Fix tileset scrollbar area changing selection (#8324)
de80d0b32 Update cordova config for new xcode/ios versions (#8321)
dc62aea8d Add support for ordering For Each by an expression, with optional limit  (#8319)

The AI agent summary is:

Summary of documentation changes:

Updated /docs/gdevelop5/events/foreach/index.md to document the new ordering feature for For Each events. Added a new "Ordering instances" section explaining that users can now choose ordered by and enter an expression (evaluated per instance) to sort instances before iterating — with ascending or descending order. Also documented the optional limit sub-feature that restricts iteration to only the first N instances after sorting.

No other documentation updates were needed: the Anchor behavior UI change (simplified editor with visual buttons) doesn't alter documented behavior parameters, and the other commits touched internals, tests, or CI only.

Please review the changes carefully before merging.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
gdevelop-wiki	Ready	Preview, Comment	Mar 3, 2026 8:22am