docs(menu): link_to takes a block for sub-items (#665)

Author: adrianthedev

docs/4.0/menu-editor-api.md

@@ -98,9 +98,18 @@ Also accepts the shared [`icon`](#icon), [`color`](#color), [`hotkey`](#hotkey),
 | `true` / `false` | Forces the state. |
 
 :::warning `active` is ignored on sub-items
-For links nested inside a `resource` block, Avo computes the active sub-item itself — inclusively, favoring the most specific (longest) matching path — and a per-link `active:` has no effect.
+For links nested inside a `resource` or `link_to` block, Avo computes the active sub-item itself — inclusively, favoring the most specific (longest) matching path — and a per-link `active:` has no effect.
 :::
 
+Passing a block nests sub-items under the link — see the [sub-items guide](./menu-editor.html#sub-items). The link itself stays clickable, and Avo forces it active while one of its children is.
+
+```ruby
+link_to "Design", path: "/admin/design" do
+  link_to "Chat", path: "/admin/design/chat"
+  link_to "Loader", path: "/admin/design/loader"
+end
+```
+
 </Option>
 
 <Option name="`resource`" headingSize="3">

docs/4.0/menu-editor.md

@@ -90,7 +90,7 @@ The `all_resources` helper takes your [authorization](./authorization) rules int
 
 ## Sub-items
 
-You can nest items beneath a `resource` by passing a block. They appear as child items under the resource link in the sidebar. Any item type can be nested; a nested `resource`, `dashboard`, `page`, `board`, or `action` resolves its own URL automatically, so only `link_to` needs an explicit `path:`. A nested `action` also inherits its enclosing resource, so you don't repeat it.
+You can nest items beneath a `resource` or a `link_to` by passing a block. They appear as child items under the parent link in the sidebar, which stays clickable and goes to its own page. Any item type can be nested; a nested `resource`, `dashboard`, `page`, `board`, or `action` resolves its own URL automatically, so only `link_to` needs an explicit `path:`. A nested `action` also inherits its enclosing resource, so you don't repeat it.
 
 ```ruby
 # config/initializers/avo.rb
@@ -104,6 +104,12 @@ Avo.configure do |config|
       board 1                         # nested kanban board
       action Avo::Actions::ExportData # nested action (inherits :projects)
     end
+
+    # A plain link nests the same way — a custom page and its sub-pages.
+    link_to "Design", path: "/admin/design" do
+      link_to "Chat", path: "/admin/design/chat"
+      link_to "Loader", path: "/admin/design/loader"
+    end
   }
 end
 ```
@@ -219,7 +225,7 @@ A [collapsable](./menu-editor-api.html#collapsable) section or group already car
 
 ## Icons
 
-The [`icon`](./menu-editor-api.html#icon) option is supported on `section` and on individual menu items (`link_to`, `resource`, `dashboard`, `page`, `form`, `board`, `action`). It is not supported on `group` or on sub-items nested inside a `resource` block.
+The [`icon`](./menu-editor-api.html#icon) option is supported on `section` and on individual menu items (`link_to`, `resource`, `dashboard`, `page`, `form`, `board`, `action`). It is not supported on `group` or on sub-items nested inside a `resource` or `link_to` block.
 
 You can use icons from [Tabler Icons](https://tabler.io/icons) (preferred in Avo 4) or from [Heroicons](https://heroicons.com/) (both `outline` and `solid` variants).