Merge branch 'main' into mckn/agents-md-datasource-plugin

Author: mckn

CHANGELOG.md

@@ -1,3 +1,42 @@
+# (Thu Nov 27 2025)
+
+#### 🐛 Bug Fix
+
+- `@grafana/[email protected]`
+  - Create Plugin: update valibot to ^1.2.0 [#2331](https://github.com/grafana/plugin-tools/pull/2331) ([@jackw](https://github.com/jackw))
+
+#### Authors: 1
+
+- Jack Westbrook ([@jackw](https://github.com/jackw))
+
+---
+
+# (Thu Nov 27 2025)
+
+#### 🐛 Bug Fix
+
+- `@grafana/[email protected]`
+  - Plugin E2E: Bump e2e selectors [#2329](https://github.com/grafana/plugin-tools/pull/2329) ([@sunker](https://github.com/sunker))
+
+#### Authors: 1
+
+- Erik Sundell ([@sunker](https://github.com/sunker))
+
+---
+
+# (Wed Nov 26 2025)
+
+#### 🐛 Bug Fix
+
+- `@grafana/[email protected]`
+  - Create Plugin: bump swc/core to ^1.14.0 to fix segfault on Linux ARM [#2328](https://github.com/grafana/plugin-tools/pull/2328) ([@xnyo](https://github.com/xnyo))
+
+#### Authors: 1
+
+- Giuseppe Guerra ([@xnyo](https://github.com/xnyo))
+
+---
+
 # (Tue Nov 25 2025)
 
 #### 🚀 Enhancement

docusaurus/docs/get-started.md

@@ -229,6 +229,7 @@ Congratulations! You've just scaffolded your first plugin which you can now acce
 ## Next steps
 
 - Start your plugin journey with one of our [plugin development tutorials](/tutorials/).
-- Learn how to [extend](/how-to-guides) its functionality.
+- Learn how to [extend](/how-to-guides) the plugin's functionality.
 - Review the [plugin examples](https://github.com/grafana/grafana-plugin-examples) to learn about good practices.
 - Learn how to [package](/publish-a-plugin/package-a-plugin), [sign](/publish-a-plugin/sign-a-plugin), and [publish](/publish-a-plugin/publish-or-update-a-plugin.md) your plugin to the Grafana [plugin catalog](https://grafana.com/plugins).
+- Use the [available resources](resources), including [Grafana Community](https://community.grafana.com/), the official Grafana Labs forums, and the [Community Slack](https://slack.grafana.com/).

docusaurus/docs/how-to-guides/app-plugins/include-page-behind-feature-toggle.md

@@ -0,0 +1,55 @@
+---
+id: include-page-behind-feature-toggle
+title: Include a page behind a feature toggle
+description: How to include a page behind a feature toggle
+keywords:
+  - grafana
+  - plugins
+  - plugin
+  - app
+  - navigation
+---
+
+# Include a page behind a feature toggle
+
+You can use feature flags to control the visibility of pages in app plugins. While pages are visible by default, you can flag them to hide them from navigation.
+
+:::note
+
+This feature is only available in Grafana 12.4 and later.
+
+:::
+
+## How it works
+
+Grafana checks for feature flags when users access plugin pages. Pages are visible by default.
+
+The flag key format is:
+
+```ini
+[feature_toggles]
+plugin-page-visible.<path> = false
+```
+
+If you set the visibility flag to `false`, the page will be hidden from the navigation. When a user tries to access it, Grafana returns a `403 Forbidden` response.
+
+To add a experimental page:
+
+1. Deploy the feature flag with the value set to false.
+1. Release or deploy the plugin with the new page.
+
+## Example
+
+To hide `/a/myorg-basic-app/my-page`:
+
+1. Set the feature flag key to `plugin-page-visible./a/myorg-basic-app/my-page`.
+2. Set the value to `false`.
+
+```ini
+[feature_toggles]
+plugin-page-visible./a/myorg-basic-app/my-page = false
+```
+
+## Related resources
+
+Refer to the [Grafana feature toggles guide](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/feature-toggles/) for Grafana-specific configuration

docusaurus/docs/how-to-guides/index.md

@@ -19,3 +19,9 @@ keywords:
 Learn how to extend Grafana plugins with additional functionality and capabilities with short guides.
 
 <DocLinkList />
+
+:::note
+
+If you have any questions reach out to the [Grafana Community forum](https://community.grafana.com/) and the [Community Slack](https://slack.grafana.com/).
+
+:::

docusaurus/docs/key-concepts/data-frames.md

@@ -13,10 +13,14 @@ sidebar_position: 40
 
 # Data frames
 
-A data frame is a collection of fields organized as columns. Each field, in turn, consists of a collection of values and metadata, such as units, scaling, and so on. 
+Grafana supports a variety of different data sources, each with its own data model. To make this possible, Grafana consolidates the query results from each of these data sources into one unified data structure called a _data frame_. A data frame is a collection of fields organized as columns. Each field, in turn, consists of a collection of values and metadata, such as units, scaling, and so on. 
+
+## Use data frames
 
 You can use data frame fields to automate configurations. For example, you could configure Grafana to automatically set the unit provided by the data source.
 
+Data frame fields also enable _data transformations_ within Grafana. A data transformation is any function that accepts a data frame as input, and returns another data frame as output. By using data frames in your plugin, you get a range of transformations for free. To learn more about data transformations in Grafana, refer to [Transform data](https://grafana.com/docs/grafana/latest/panels-visualizations/query-transform-data/transform-data).
+
 ## Data frame fields
 
 For a data frame to be valid:
@@ -43,12 +47,6 @@ In the plugin frontend code you can use the function [`ensureTimeField`](https:/
 
 This function converts strings following the ISO 8601 format (for example, `2017-07-19 00:00:00.000`), JavaScript's `Date` objects, and strings with relative times (for example, `now-10s`) to `Numbers`.
 
-## Data transformations
-
-Data frame fields enable _data transformations_ within Grafana. A data transformation is any function that accepts a data frame as input, and returns another data frame as output. By using data frames in your plugin, you get a range of transformations for free.
-
-To learn more about data transformations in Grafana, refer to [Transform data](https://grafana.com/docs/grafana/latest/panels-visualizations/query-transform-data/transform-data).
-
 ## Available data frames
 
 The following data frame types are available:

docusaurus/docs/resources.md

@@ -16,10 +16,9 @@ sidebar_position: 70
 
 # Resources
 
-Here are some additional related to plugins that may make your plugin development journey easier.
+Here are some additional resources related to plugins that may make your plugin development journey easier.
 
-- [Grafana developer portal](https://grafana.com/developers/) - Home to plugin documentation, Scenes API, React components library, Data Plane contract, and more.
-- [Grafana Design System](https://grafana.com/developers/saga/about/overview/) - Saga is our design system establishing the shared visual language for all Grafana Labs products.
+- [Grafana developer portal](https://grafana.com/developers/) - Home to plugin documentation, data structure documentation, React components library, and more.
 - [Grafana API reference](https://grafana.com/docs/grafana/latest/developers/http_api/) - The backend HTTP API for Grafana. 
 - [Grafana Community](https://community.grafana.com/) - Official Grafana Labs forums on plugin development and other topics.
 - [Community Slack](https://slack.grafana.com/) - Discuss plugin development at the Grafana Labs community Slack.

docusaurus/docs/tutorials/index.md

@@ -17,3 +17,9 @@ keywords:
 Learn how to create a Grafana plugin from scratch by following our end-to-end tutorials for every type of Grafana plugin.
 
 <DocLinkList />
+
+:::note
+
+If you have any questions reach out to the [Grafana Community forum](https://community.grafana.com/) and the [Community Slack](https://slack.grafana.com/).
+
+:::

docusaurus/website/package.json

@@ -1,6 +1,6 @@
 {
   "name": "website",
-  "version": "5.1.0",
+  "version": "5.1.1",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",

docusaurus/website/sidebars.ts

@@ -124,6 +124,7 @@ const sidebars: SidebarsConfig = {
         'how-to-guides/app-plugins/use-llms-and-mcp',
         'how-to-guides/app-plugins/use-a-service-account',
         'how-to-guides/app-plugins/work-with-nested-plugins',
+        'how-to-guides/app-plugins/include-page-behind-feature-toggle',
       ],
     },