Update docs (#343)

Author: rami-elementor

src/dynamic-tags/dynamic-tags-groups.md

@@ -8,18 +8,30 @@ To simplify navigation, all tags are arranged into groups. This allows users to
 
 ## Available Groups
 
-Elementor Pro adds the following groups:
+Elementor core registers one built-in group:
 
-* **Post** - Post related dynamic data.
-* **Archive** - Theme archive related dynamic data.
-* **Site** - Site related dynamic data.
-* **Media** - Dynamic data based on media files.
-* **Actions** - Custom dynamic data.
-* **Author** - Post author dynamic data.
-* **Comments** - Post comments dynamic data.
+| Slug | Label |
+|------|-------|
+| `base` | Base Tags |
+
+Elementor Pro registers additional groups:
+
+| Slug | Label |
+|------|-------|
+| `post` | Post |
+| `archive` | Archive |
+| `site` | Site |
+| `media` | Media |
+| `action` | Actions |
+| `author` | Author |
+| `comments` | Comments |
 
 If you would like to use the groups added by Elementor Pro, your addons must [make sure Elementor Pro was loaded](./../addons/compatibility/).
 
+::: tip Groups vs. Categories
+Groups control where a tag appears in the **dynamic tags panel list** (the visual grouping users see). Categories are a separate concept: they control which **controls** a tag can appear on (for example, `text`, `url`, `image`, `color`). A tag declares its categories in `get_categories()` and its display group in `get_group()`.
+:::
+
 ## Applying Groups
 
 When creating new dynamic tags, you can set the tag group by returning group names with the `get_group()` method:
@@ -36,7 +48,7 @@ class Elementor_Test_Tag extends \Elementor\Core\DynamicTags\Tag {
 
 ## Creating New Groups
 
-Elementor Pro’s dynamic tags manager lets external developers create custom groups using the `elementor/dynamic_tags/register_tags` action hook:
+External developers can create custom groups using the `elementor/dynamic_tags/register` action hook, which passes the dynamic tags manager as a parameter:
 
 ```php
 /**

src/widgets/add-new-widget.md

@@ -5,7 +5,7 @@
 Elementor offers many built-in widgets out of the box, but it also allows external developers to register new widgets.
 
 ## Hooks
- 
+
 To do that we simply hook to the `elementor/widgets/register` action which provides access to the widgets manager as a parameter. Developers can use the manager to add new widgets using the `register()` method with the widget instance.
 
 ## Registering Widgets

src/widgets/widget-dependencies.md

@@ -26,7 +26,7 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 
 * **Style Dependencies** – The `get_style_depends()` method lets you define the CSS files required to run the widget.
 
-Please note that these dependencies should already be registered. The widget class only informs Elementor what dependencies it needs to enqueue.
+Both methods must return an array of **registered** script/style handles. The widget class does not register anything itself — it only tells Elementor which already-registered assets to enqueue when the widget is rendered. Returning an unregistered handle has no effect.
 
 ## Registering Scripts & Styles in WordPress
 
@@ -143,3 +143,27 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 ```
 
 This can be handy when 3rd party widgets register their own frontend handlers. Read more about it on [controls `frontend_available` argument](./../editor-controls/frontend-available/).
+
+### Editor-Only Dependencies
+
+`get_script_depends()` and `get_style_depends()` are enqueued whenever the widget renders — including inside the editor preview iframe. They are not the right place for scripts that should only load in the editor panel itself (outside the preview).
+
+For assets needed only inside the editor panel, register and enqueue them via the `elementor/editor/before_enqueue_scripts` or `elementor/editor/after_enqueue_scripts` action hooks instead:
+
+```php
+function my_plugin_register_editor_only_assets() {
+	wp_register_script(
+		'my-widget-editor-script',
+		plugins_url( 'assets/js/my-widget-editor.js', __FILE__ ),
+		[ 'elementor-editor' ]
+	);
+}
+add_action( 'wp_enqueue_scripts', 'my_plugin_register_editor_only_assets' );
+
+function my_plugin_enqueue_editor_only_assets() {
+	wp_enqueue_script( 'my-widget-editor-script' );
+}
+add_action( 'elementor/editor/before_enqueue_scripts', 'my_plugin_enqueue_editor_only_assets' );
+```
+
+This asset loads in the editor panel but is never enqueued on the frontend or inside the preview iframe. See [Editor Scripts](./../scripts-styles/editor-scripts/) for more details.