feat(ent3): add experimental badge for --use-pacha-tree (#6857)

* fix(ent3): Add link target and experimental caution for PachaTree option.

* feat(ent3): add experimental badge for --use-pacha-tree

Document the experimental PachaTree storage engine option with a
styled badge and caution callout. Add reusable .badge.experimental
class using the existing caution color palette for light/dark modes.

- Add experimental badge to serve options table and config-options
- Add badge theme variables referencing $article-caution-* colors
- Use custom heading ID to preserve #use-pacha-tree anchor

assets/styles/layouts/article/_badges.scss

@@ -5,7 +5,7 @@
   border-radius: .6rem;
   font-weight: bold;
   vertical-align: top;
-  
+
   &.dvc {
     color: #2e7d2e;
     background-color: #e8f5e8;
@@ -14,4 +14,8 @@
     color: #1976d2;
     background-color: #e3f2fd;
   }
+  &.experimental {
+    color: $badge-experimental-text;
+    background-color: $badge-experimental-bg;
+  }
 }

assets/styles/themes/_theme-dark.scss

@@ -266,3 +266,7 @@ $influxdb-logo: url('/svgs/influxdb-logo-white.svg') !default;
 // Code placeholder colors
 $code-placeholder: #e659a2;
 $code-placeholder-hover: $br-teal;
+
+// Badge colors
+$badge-experimental-text: $article-caution-text;
+$badge-experimental-bg: $article-caution-bg;

assets/styles/themes/_theme-light.scss

@@ -265,3 +265,7 @@ $diagram-arrow: $g14-chromium !default;
 // Code placeholder colors
 $code-placeholder: $br-new-magenta !default;
 $code-placeholder-hover: $br-new-purple !default;
+
+// Badge colors
+$badge-experimental-text: $article-caution-text !default;
+$badge-experimental-bg: $article-caution-bg !default;

content/influxdb3/enterprise/reference/cli/influxdb3/serve.md

@@ -153,7 +153,7 @@ influxdb3 serve [OPTIONS]
 |                  | `--traces-jaeger-debug-name`                         | _See [configuration options](/influxdb3/enterprise/reference/config-options/#traces-jaeger-debug-name)_                         |
 |                  | `--traces-jaeger-max-msgs-per-second`                | _See [configuration options](/influxdb3/enterprise/reference/config-options/#traces-jaeger-max-msgs-per-second)_                |
 |                  | `--traces-jaeger-tags`                               | _See [configuration options](/influxdb3/enterprise/reference/config-options/#traces-jaeger-tags)_                               |
-|                  | `--use-pacha-tree`                                   | _See [configuration options](/influxdb3/enterprise/reference/config-options/#use-pacha-tree)_                                   |
+|                  | `--use-pacha-tree` <span class="badge experimental">Experimental</span> | _See [configuration options](/influxdb3/enterprise/reference/config-options/#use-pacha-tree)_ |
 |                  | `--virtual-env-location`                             | _See [configuration options](/influxdb3/enterprise/reference/config-options/#virtual-env-location)_                             |
 |                  | `--wait-for-running-ingestor`                        | _See [configuration options](/influxdb3/enterprise/reference/config-options/#wait-for-running-ingestor)_                        |
 |                  | `--wal-flush-interval`                               | _See [configuration options](/influxdb3/enterprise/reference/config-options/#wal-flush-interval)_                               |

content/shared/influxdb3-cli/config-options.md

@@ -138,6 +138,9 @@ For detailed information about thread allocation, see the [Resource Limits](#res
   {{% /show-in %}}
 - [object-store](#object-store)
 - [query-file-limit](#query-file-limit)
+  {{% show-in "enterprise" %}}
+- [use-pacha-tree](#use-pacha-tree)
+  {{% /show-in %}}
 
 {{% show-in "enterprise" %}}
 
@@ -276,6 +279,26 @@ This option supports the following values:
 
 {{% show-in "enterprise" %}}
 
+#### use-pacha-tree <span class="badge experimental">Experimental</span> {#use-pacha-tree}
+
+Enables the PachaTree storage engine.
+
+> [!Caution]
+> PachaTree is an experimental feature not for production use.
+> It might not be compatible with other features and configuration options.
+
+**Default:** `false`
+
+| influxdb3 serve option | Environment variable           |
+| :--------------------- | :----------------------------- |
+| `--use-pacha-tree`     | `INFLUXDB3_USE_PACHA_TREE`     |
+
+***
+
+{{% /show-in %}}
+
+{{% show-in "enterprise" %}}
+
 ### Licensing
 
 #### license-email