From 30cba4a23f1642f59322cd6f8523c18db4e0e75d Mon Sep 17 00:00:00 2001
From: Icaro Ryan Souza <icaroryan.contact@gmail.com>
Date: Wed, 7 Aug 2024 11:44:16 -0400
Subject: [PATCH] Add docs for visibility control for `tabs` and `tab`

---
 docs/3.0/tabs.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/docs/3.0/tabs.md b/docs/3.0/tabs.md
index 83ec11fe..a97cd9c7 100644
--- a/docs/3.0/tabs.md
+++ b/docs/3.0/tabs.md
@@ -75,3 +75,40 @@ end
 ## Display counter indicator on tabs switcher
 
 Check [this recipe](guides/tabs-counter-indicator.html) on how to enhance your tabs switcher with a counter for each association tab.
+
+## Visibility control
+
+<VersionReq version="3.10.10" />
+
+Both `tabs` and individual `tab` components support a `visible` option that allows you to dynamically control their visibility based on certain conditions. For example, you might want to hide a tab if the user doesn't have the necessary permissions to view its content.
+
+<Option name="`visible`">
+
+The `visible` option allows you to control the visibility of either a group of tabs or an individual tab. It can be a `boolean` or a lambda.
+
+#### Example
+
+```ruby
+tabs visible: -> { resource.record.enabled? } do
+  tab name: "General Information" do
+    panel do
+      field :name, as: :text
+      field :email, as: :text
+    end
+  end
+  tab "Admin Information", visible: -> { current_user.is_admin? } do
+    panel do
+      field :role, as: :text
+      field :permissions, as: :text
+    end
+  end
+end
+```
+
+In this example:
+- The entire group of tabs is only visible if the record is enabled (`resource.record.enabled?`).
+- Within this group, the "General Information" tab is always visible when the tabs are shown.
+- The "Admin Information" tab is only visible for admin records (`resource.record.admin?`).
+
+</Option>
+