Layout

docs/.vitepress/config.js

@@ -153,14 +153,20 @@ const config = {
             {text: "Record previews", link: "/3.0/record-previews.html"},
             {text: "Scopes", link: "/3.0/scopes.html"},
             {text: "Records reordering", link: "/3.0/records-reordering.html"},
-            {text: "Resource sidebar", link: "/3.0/resource-sidebar.html"},
-            {text: "Resource panels", link: "/3.0/resource-panels.html"},
-            {text: "Resource tabs", link: "/3.0/tabs.html"},
             {text: "Discreet information", link: "/3.0/discreet-information.html"},
             {text: "Customizable controls", link: "/3.0/customizable-controls.html"},
             {text: "Cover and Profile Photos", link: "/3.0/cover-and-profile-photos.html"},
           ],
         },
+        {
+          text: "Layout",
+          items: [
+            {text: "Panels", link: "/3.0/resource-panels.html"},
+            {text: "Clusters", link: "/3.0/resource-clusters.html"},
+            {text: "Sidebars", link: "/3.0/resource-sidebar.html"},
+            {text: "Tabs", link: "/3.0/tabs.html"},
+          ],
+        },
         {
           text: "Views",
           items: [

docs/3.0/fields.md

@@ -188,7 +188,6 @@ class Avo::Resources::User < Avo::BaseResource
 end
 ```
 
-
 ## Field Types
 
 <ul>

docs/3.0/resource-clusters.md

@@ -0,0 +1,36 @@
+# Several fields in a cluster
+
+<VersionReq version="3.18.0" class="mt-2" />
+
+:::info
+To fully understand this section, you should be familiar with the [`stacked`](./field-wrappers.html#stacked) field option and [`resource panels`](./resource-panels.html). These concepts will help you structure and customize your fields effectively.
+:::
+
+The `cluster` DSL allows you to group multiple fields horizontally within a [`panel`](./resource-panels.html#computed-panels-vs-manual-customization). This is useful for organizing related fields in a structured layout.
+
+To enhance readability and maintain a well-organized UI, it is recommended to use the [`stacked`](./field-wrappers.html#stacked) option for fields inside clusters.
+
+<Image src="/assets/img/row.png" width="1028" height="230" alt="Field naming convention" />
+
+```ruby{4-18}
+# app/avo/resources/user.rb
+class Avo::Resources::Person < Avo::BaseResource
+  def fields
+    panel "Address" do
+      cluster do
+        field :street_address, stacked: true do
+          "1234 Elm Street"
+        end
+
+        field :city, stacked: true do
+          "Los Angeles"
+        end
+
+        field :zip_code, stacked: true do
+          "15234"
+        end
+      end
+    end
+  end
+end
+```

docs/3.0/upgrade.md

@@ -31,6 +31,40 @@ You can now refine this method to restrict access for specific users or even def
 
 </Option>
 
+<Option name="Deprecation of `row`">
+
+The `row` DSL has been available but undocumented for some time. As of <Version version="3.18.0" />, it has been officially deprecated in favor of `cluster`, which is now properly documented [here](./resource-clusters.html).
+
+### Steps to Update
+
+Replace all `row do` with `cluster do`.
+
+```ruby
+# app/avo/resources/user.rb
+class Avo::Resources::Person < Avo::BaseResource
+  def fields
+    panel "Address" do
+      row do # [!code --]
+      cluster do # [!code ++]
+        field :street_address, stacked: true do
+          "1234 Elm Street"
+        end
+
+        field :city, stacked: true do
+          "Los Angeles"
+        end
+
+        field :zip_code, stacked: true do
+          "15234"
+        end
+      end
+    end
+  end
+end
+```
+
+</Option>
+
 
 ## Upgrade from 3.16.2 to 3.16.3