Merge with master

Author: ashvayka

_includes/docs/user-guide/attributes.md

@@ -138,7 +138,7 @@ The user may change the attribute via UI. The script or other server-side applic
 
 #### Administration UI
 
-{% include images-gallery.html imageCollection="shared-attrs-ui" %}
+{% include images-gallery.html imageCollection="shared-attrs-ui" showListImageTitles="true" %}
 
 {% include templates/info-banner.md content=bulk_provisioning %}
 

_includes/docs/user-guide/ui/devices.md

@@ -36,12 +36,17 @@ Tenant administrators and users with appropriate permissions can create, edit, o
 ### Adding new device
 
 To add a new device:
-- Navigate to **Entities** ⟶ **Devices**. {% unless docsPrefix == null %}By default, you will see the "**All**" asset group.{% endunless %}
+- Navigate to **Entities** ⟶ **Devices**. {% unless docsPrefix == null %}By default, you will see the "**All**" device group.{% endunless %}
 - Click the "**+**" icon in the upper-right corner and select "**Add new device**" from drop-down menu.
 - In the device creation form, fill in the required fields:
     - **Name** – a unique name for the device.
     - **[Device profile](/docs/{{docsPrefix}}user-guide/device-profiles/){:target="_blank"}** – by default, the profile is set to "**default**", but you can choose a different profile if needed.
-- Optional fields such as label or description can be filled in if needed.
+    {% if (docsPrefix == "pe/") or (docsPrefix == "paas/") or (docsPrefix == "paas/eu/") %}
+    - **Owner and groups:** Helps with organization and access control.
+      - **Owner**: Select the owner from the dropdown list. The device will be created at that owner’s level. By default, the field is pre-filled with the Customer or Tenant name based on where you add the device. You can change it before confirming adding.
+      - **Groups**: Optional field. Add the device to existing device groups or create a new one at the selected owner level. Note: every device is automatically added to the "**All**" group of that owner.      
+    {% endif %}
+- Optional fields such as **Label** or **Description** can be filled in if needed.
 - Click "**Add**".
 
 Device successfully created and is now available in the list.
@@ -162,6 +167,11 @@ On the "<b>Devices</b>" page there is an option "<b>Include customer entities</b
 
 {% include images-gallery.html imageCollection="include-customer-entities" showListImageTitles="true" %}
 
+## Share device
+You can share devices by adding them to a device group and then sharing the group with a customer.
+
+For detailed instructions, please see the section on how to [Share device group](#share-device-group).
+
 {% endif %}
 
 {% unless docsPrefix == null %}
@@ -189,7 +199,7 @@ To make the group private again, follow the same steps using the "**Make private
 
 ## Share device group
 
-You can share an device group with one or more customers. This is useful, for example, when multiple customers need access to the same device.
+You can share a device group with one or more customers. This is useful, for example, when multiple customers need access to the same device.
 
 > You cannot share an individual device — only the device group that contains it.
 
@@ -201,6 +211,23 @@ To share an device group:
 - Confirm the action by clicking "**Share**".
 
 {% include images-gallery.html imageCollection="share-device-group" %}
+
+**Managing and Verifying Permissions**
+
+After a device group has been shared, you can view, edit, or revoke permissions at any time.
+
+1. From the "Device groups" list, click on the pencil button of the desired group to open the "Entity group details".
+
+2. Navigate to the Permissions tab.
+
+3. On this tab, you will see a complete list of all permissions granted for this group. Here you can:
+
+- **Add** a new permission: Click the "+" icon in the top right corner of the panel. A dialog window will appear where you can select a role and a user group to grant access to.
+
+- **Edit** an existing permission: Click the pencil icon next to the permission you want to modify.
+
+- **Delete** a permission: Click the trash can icon to remove access for that user group.
+
 {% endunless %}
 
 ## Device details

_includes/docs/user-guide/widgets.md

@@ -409,19 +409,19 @@ In the legend settings, you can:
 
 The legend displays a label for each [data key](/docs/{{docsPrefix}}user-guide/widgets/#data-keys). When a widget contains data from multiple devices, or when several devices use the same data key name (for example, temperature), it may be difficult to determine which key value corresponds to which device in the legend or tooltip.
 
-To make the legend or tooltip clearer, you should use <b>${entityName}</b> or <b>${entityLabel}</b> in the data key configuration.
+To make the legend clearer, you should use **${entityName}** or **${entityLabel}** in the **Label** field of the data key configuration.
 
-- <b>${entityName}</b> – a variable that automatically inserts the system name of the entity in the legend or tooltip. This helps clearly identify the object, especially when its technical name or unique identifier is important.   
-  Example: If a device has the name <b>sensor-101</b>, then in the field where <b>${entityName}</b> is used, you will see <b>sensor-101</b>.
+- **${entityName}** – a variable that automatically inserts the system name of the entity in the legend. This helps clearly identify the object, especially when its technical name or unique identifier is important.   
+  Example: If a device has the name **sensor-101**, then in the field where **${entityName}** is used, you will see **sensor-101**.
 
 {% include images-gallery.html imageCollection="entity-name-legend" %}
 
-- <b>${entityLabel}</b> – a variable that inserts the entity&#39;s label in the legend or tooltip.. This is often used as a human-readable label and allows you to display a more descriptive name of the device or entity.   
+- **${entityLabel}** – a variable that inserts the entity's label in the legend. This is often used as a human-readable label and allows you to display a more descriptive name of the device or entity.   
    Example: A device has:
-    - <b>Name</b> = <b>sensor-101</b>
-    - <b>Label</b> = <b>Temperature Sensor, Warehouse #1</b>
+    - **Name** = **sensor-101**
+    - **Label** = **Temperature Sensor, Warehouse #1**
 
-    In the field where <b>${entityLabel}</b> is used, the operator will see the more understandable text: <b>Temperature Sensor, Warehouse #1</b>.
+    In the field where **${entityLabel}** is used, the operator will see the more understandable text: **Temperature Sensor, Warehouse #1**.
 
 {% include images-gallery.html imageCollection="entity-label-legend" %}
 
@@ -466,7 +466,23 @@ You can change the appearance of the chart grid: customize the color of the back
 
 - **Show cumulative values in stacking mode**. While stacking mode is on, you can check the box "Cumulative values" to enable your chart to display sum of all entity values.
 
-**Tooltip value format function, f(value, latestData)** is used when you want to manually customize the tooltip.
+Tooltip value format function, **f(value, latestData)** is used when you want to manually customize the tooltip.
+
+To make the tooltip clearer, you should use **${entityName}** or **${entityLabel}** in the **Label** field of the data key configuration.
+
+- **${entityName}** – a variable that automatically inserts the system name of the entity in the tooltip. This helps clearly identify the object, especially when its technical name or unique identifier is important.   
+  Example: If a device has the name **Sensor 1**, then in the field where **${entityName}** is used, you will see **Sensor 1**.
+
+{% include images-gallery.html imageCollection="entity-name-tooltip" %}
+
+- **${entityLabel}** – a variable that inserts the entity's label in the tooltip. This is often used as a human-readable label and allows you to display a more descriptive name of the device or entity.   
+   Example: A device has:
+    - **Name** = **Sensor 1**
+    - **Label** = **Sensor 1 Label**
+
+    In the field where **${entityLabel}** is used, the operator will see the more understandable text: **Sensor 1 Label**.
+
+{% include images-gallery.html imageCollection="entity-label-tooltip" %}
 
 You can customize the values that will be displayed in the tooltip via tooltip settings or
 [Advanced Data key configuration](/docs/{{docsPrefix}}user-guide/ui/advanced-data-key-configuration/#tooltip-settings){:target="_blank"}.

docs/paas/eu/user-guide/attributes.md

@@ -6,25 +6,25 @@ title: Working with IoT device attributes
 description: IoT device management using ThingsBoard attributes feature 
 server-side-attrs-ui:
     0:
-        image: https://img.thingsboard.io/user-guide/attributes/add-server-side-pe-src.png
-        title: 'Select Device Group. Click on the particular device row to open device details. Select "Attributes" tab. Choose "Server attributes" scope. Click "+" Icon.'
+        image: /images/user-guide/attributes/add-server-side-pe-src.png
+        title: 'Go to Entities → Devices and open the device you want to edit by clicking its row. In the device details, open the "Attributes" tab, select the "Server attributes" scope, and click the "+" icon to add a new attribute.'
     1:
-        image: https://img.thingsboard.io/user-guide/attributes/add-server-side-pe2-src.png
-        title: 'Input new attribute name. Select attribute value type and input attribute value.'
+        image: /images/user-guide/attributes/add-server-side-pe2-src.png
+        title: 'In the dialog, enter the attribute key, select the value type (for example, String), and provide a value.'
     2:
-        image: https://img.thingsboard.io/user-guide/attributes/add-server-side-pe3-src.png
-        title: 'Sort using "Last update time" to quickly locate the newly created attribute.'
+        image: /images/user-guide/attributes/add-server-side-pe3-src.png
+        title: 'After saving, the new attribute appears in the list with its key, value, and last update time. Sort using "Last update time" to quickly locate the newly created attribute.'
 
 shared-attrs-ui:
     0:
-        image: https://img.thingsboard.io/user-guide/attributes/add-shared-pe-src.png
-        title: 'Select Device Group. Click on the particular device row to open device details. Select "Attributes" tab. Choose "Shared attributes" scope. Click "+" Icon.'
+        image: /images/user-guide/attributes/add-shared-pe-src.png
+        title: 'Go to Entities → Devices and open the device you want to edit by clicking its row. In the device details, open the "Attributes" tab, select the "Shared attributes" scope, and click the "+" icon to add a new attribute.'
     1:
-        image: https://img.thingsboard.io/user-guide/attributes/add-shared-pe2-src.png
-        title: 'Input new attribute name. Select attribute value type and input attribute value.'
+        image: /images/user-guide/attributes/add-shared-pe2-src.png
+        title: 'In the dialog, enter the attribute key, select the value type (for example, Double), and provide a value.'
     2:
-        image: https://img.thingsboard.io/user-guide/attributes/add-shared-pe3-src.png
-        title: 'Observe the new attribute.'
+        image: /images/user-guide/attributes/add-shared-pe3-src.png
+        title: 'After saving, the new attribute appears in the list with its key, value, and last update time.'
 
 ---
 

docs/paas/eu/user-guide/widgets.md

@@ -364,6 +364,34 @@ entity-label-legend:
         image: https://img.thingsboard.io/user-guide/widgets/overview/appearance/entity-label-legend-3-pe.png
         title: 'Now, each key includes a human-readable label of the device it belongs to.'
 
+entity-name-tooltip:
+    0:
+        image: /images/user-guide/widgets/overview/appearance/tooltipName-before-configuration-PE.png
+        title: 'When a widget contains data from multiple devices, or when several devices use the same data key name, it may be difficult to determine which key value corresponds to which device in the tooltip.'
+    1:
+        image: /images/user-guide/widgets/overview/appearance/tooltipName-configuration-1-PE.png
+        title: 'Open the data key configuration.'
+    2:
+        image: /images/user-guide/widgets/overview/appearance/tooltipName-configuration-2-PE.png
+        title: 'Use the <b>${entityName}</b> variable in the key label, which automatically inserts the system name of the entity. This helps clearly identify the object, especially when its technical name or unique identifier is important.'
+    3:
+        image: /images/user-guide/widgets/overview/appearance/tooltipName-configuration-3-PE.png
+        title: 'Use this variable for other data keys as well.'
+    4:
+        image: /images/user-guide/widgets/overview/appearance/tooltipName-after-configuration-PE.png
+        title: 'Now, each key includes the name of the device it belongs to.'
+
+entity-label-tooltip:
+    0:
+        image: /images/user-guide/widgets/overview/appearance/tooltipLabel-configuration-1-PE.png
+        title: 'Use the <b>${entityLabel}</b> variable in the key label, that inserts the entity&#39;s label in the tooltip. This is often used as a human-readable label and allows you to display a more descriptive name of the device or entity.'
+    1:
+        image: /images/user-guide/widgets/overview/appearance/tooltipLabel-configuration-2-PE.png
+        title: 'Use this variable for other data keys as well.'
+    2:
+        image: /images/user-guide/widgets/overview/appearance/tooltipLabel-after-configuration-PE.png
+        title: 'Now, each key includes a human-readable label of the device it belongs to.'
+
 appearance-vertical-axis:
     0:
         image: https://img.thingsboard.io/user-guide/widgets/overview/appearance/appearance-vertical-axis-1-pe.png

docs/paas/user-guide/attributes.md

@@ -6,25 +6,25 @@ title: Working with IoT device attributes
 description: IoT device management using ThingsBoard attributes feature 
 server-side-attrs-ui:
     0:
-        image: https://img.thingsboard.io/user-guide/attributes/add-server-side-pe-src.png
-        title: 'Select Device Group. Click on the particular device row to open device details. Select "Attributes" tab. Choose "Server attributes" scope. Click "+" Icon.'
+        image: /images/user-guide/attributes/add-server-side-pe-src.png
+        title: 'Go to Entities → Devices and open the device you want to edit by clicking its row. In the device details, open the "Attributes" tab, select the "Server attributes" scope, and click the "+" icon to add a new attribute.'
     1:
-        image: https://img.thingsboard.io/user-guide/attributes/add-server-side-pe2-src.png
-        title: 'Input new attribute name. Select attribute value type and input attribute value.'
+        image: /images/user-guide/attributes/add-server-side-pe2-src.png
+        title: 'In the dialog, enter the attribute key, select the value type (for example, String), and provide a value.'
     2:
-        image: https://img.thingsboard.io/user-guide/attributes/add-server-side-pe3-src.png
-        title: 'Sort using "Last update time" to quickly locate the newly created attribute.'
+        image: /images/user-guide/attributes/add-server-side-pe3-src.png
+        title: 'After saving, the new attribute appears in the list with its key, value, and last update time. Sort using "Last update time" to quickly locate the newly created attribute.'
 
 shared-attrs-ui:
     0:
-        image: https://img.thingsboard.io/user-guide/attributes/add-shared-pe-src.png
-        title: 'Select Device Group. Click on the particular device row to open device details. Select "Attributes" tab. Choose "Shared attributes" scope. Click "+" Icon.'
+        image: /images/user-guide/attributes/add-shared-pe-src.png
+        title: 'Go to Entities → Devices and open the device you want to edit by clicking its row. In the device details, open the "Attributes" tab, select the "Shared attributes" scope, and click the "+" icon to add a new attribute.'
     1:
-        image: https://img.thingsboard.io/user-guide/attributes/add-shared-pe2-src.png
-        title: 'Input new attribute name. Select attribute value type and input attribute value.'
+        image: /images/user-guide/attributes/add-shared-pe2-src.png
+        title: 'In the dialog, enter the attribute key, select the value type (for example, Double), and provide a value.'
     2:
-        image: https://img.thingsboard.io/user-guide/attributes/add-shared-pe3-src.png
-        title: 'Observe the new attribute.'
+        image: /images/user-guide/attributes/add-shared-pe3-src.png
+        title: 'After saving, the new attribute appears in the list with its key, value, and last update time.'
 
 ---