From 58c23abe0632f28f3e729942d80e0eb2fd6c8ca1 Mon Sep 17 00:00:00 2001
From: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Date: Thu, 14 Nov 2024 20:08:03 +1100
Subject: [PATCH] [8.x] [ES|QL] Adds tech preview label in the docs (#199730)
 (#200118)

# Backport

This will backport the following commits from `main` to `8.x`:
- [[ES|QL] Adds tech preview label in the docs
(#199730)](https://github.com/elastic/kibana/pull/199730)

<!--- Backport version: 9.4.3 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Stratoula
Kalafateli","email":"efstratia.kalafateli@elastic.co"},"sourceCommit":{"committedDate":"2024-11-14T07:24:42Z","message":"[ES|QL]
Adds tech preview label in the docs (#199730)\n\n## Summary\r\n\r\nAdds
a tech preview label in the docs. The information comes from the
ES\r\n(changed the script accordingly)\r\n\r\n<img width=\"590\"
alt=\"image\"\r\nsrc=\"https://github.com/user-attachments/assets/0b73b4de-425d-4bbd-b896-92f42faba40d\">","sha":"34c47c8df1ac97197c5077fb1cf130241b9c79db","branchLabelMapping":{"^v9.0.0$":"main","^v8.17.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","v9.0.0","Feature:ES|QL","Team:ESQL","backport:version","v8.17.0"],"title":"[ES|QL]
Adds tech preview label in the
docs","number":199730,"url":"https://github.com/elastic/kibana/pull/199730","mergeCommit":{"message":"[ES|QL]
Adds tech preview label in the docs (#199730)\n\n## Summary\r\n\r\nAdds
a tech preview label in the docs. The information comes from the
ES\r\n(changed the script accordingly)\r\n\r\n<img width=\"590\"
alt=\"image\"\r\nsrc=\"https://github.com/user-attachments/assets/0b73b4de-425d-4bbd-b896-92f42faba40d\">","sha":"34c47c8df1ac97197c5077fb1cf130241b9c79db"}},"sourceBranch":"main","suggestedTargetBranches":["8.x"],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","branchLabelMappingKey":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/199730","number":199730,"mergeCommit":{"message":"[ES|QL]
Adds tech preview label in the docs (#199730)\n\n## Summary\r\n\r\nAdds
a tech preview label in the docs. The information comes from the
ES\r\n(changed the script accordingly)\r\n\r\n<img width=\"590\"
alt=\"image\"\r\nsrc=\"https://github.com/user-attachments/assets/0b73b4de-425d-4bbd-b896-92f42faba40d\">","sha":"34c47c8df1ac97197c5077fb1cf130241b9c79db"}},{"branch":"8.x","label":"v8.17.0","branchLabelMappingKey":"^v8.17.0$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Stratoula Kalafateli <efstratia.kalafateli@elastic.co>
---
 .../scripts/generate_esql_docs.ts             |  24 +++-
 .../src/components/shared/documentation.scss  |   4 +
 .../shared/documentation_content.tsx          |  22 +++-
 .../generated/aggregation_functions.tsx       |  13 +++
 .../sections/generated/scalar_functions.tsx   | 104 +++++++++++++++++-
 5 files changed, 158 insertions(+), 9 deletions(-)

diff --git a/packages/kbn-language-documentation/scripts/generate_esql_docs.ts b/packages/kbn-language-documentation/scripts/generate_esql_docs.ts
index 072d53a02753a..da42dc7a44480 100644
--- a/packages/kbn-language-documentation/scripts/generate_esql_docs.ts
+++ b/packages/kbn-language-documentation/scripts/generate_esql_docs.ts
@@ -13,6 +13,11 @@ import fs from 'fs';
 import path from 'path';
 import { functions } from '../src/sections/generated/scalar_functions';
 
+interface DocsSectionContent {
+  description: string;
+  preview?: boolean;
+}
+
 (function () {
   const pathToElasticsearch = process.argv[2];
   const { scalarFunctions, aggregationFunctions } = loadFunctionDocs(pathToElasticsearch);
@@ -41,8 +46,8 @@ function loadFunctionDocs(pathToElasticsearch: string) {
     .readdirSync(definitionsPath)
     .map((file) => JSON.parse(fs.readFileSync(`${definitionsPath}/${file}`, 'utf-8')));
 
-  const scalarFunctions = new Map<string, string>();
-  const aggregationFunctions = new Map<string, string>();
+  const scalarFunctions = new Map<string, DocsSectionContent>();
+  const aggregationFunctions = new Map<string, DocsSectionContent>();
 
   // Iterate over each file in the directory
   for (const file of docsFiles) {
@@ -64,10 +69,16 @@ function loadFunctionDocs(pathToElasticsearch: string) {
 
       // Add the function name and content to the map
       if (functionDefinition.type === 'eval') {
-        scalarFunctions.set(functionName, content);
+        scalarFunctions.set(functionName, {
+          description: content,
+          preview: functionDefinition.preview,
+        });
       }
       if (functionDefinition.type === 'agg') {
-        aggregationFunctions.set(functionName, content);
+        aggregationFunctions.set(functionName, {
+          description: content,
+          preview: functionDefinition.preview,
+        });
       }
     }
   }
@@ -75,10 +86,10 @@ function loadFunctionDocs(pathToElasticsearch: string) {
   return { scalarFunctions, aggregationFunctions };
 }
 
-function writeFunctionDocs(functionDocs: Map<string, string>, pathToDocsFile: string) {
+function writeFunctionDocs(functionDocs: Map<string, DocsSectionContent>, pathToDocsFile: string) {
   const codeStrings = Array.from(functionDocs.entries()).map(([name, doc]) => {
     const docWithoutLinks = removeAsciiDocInternalCrossReferences(
-      doc,
+      doc.description,
       Array.from(functionDocs.keys())
     );
     return `
@@ -91,6 +102,7 @@ function writeFunctionDocs(functionDocs: Map<string, string>, pathToDocsFile: st
         defaultMessage: '${name.toUpperCase()}',
       }
     ),
+    preview: ${doc.preview || false},
     description: (
       <Markdown
         openLinksInNewTab
diff --git a/packages/kbn-language-documentation/src/components/shared/documentation.scss b/packages/kbn-language-documentation/src/components/shared/documentation.scss
index 2db3d25619d6e..94478c2592aa3 100644
--- a/packages/kbn-language-documentation/src/components/shared/documentation.scss
+++ b/packages/kbn-language-documentation/src/components/shared/documentation.scss
@@ -71,6 +71,10 @@
   margin-top: $euiSizeXXL;
 }
 
+.documentation__techPreviewBadge {
+  margin-bottom: $euiSizeS;
+}
+
 .documentation__docsTextGroup {
   border-top: $euiBorderThin;
   padding-top: $euiSizeXXL;
diff --git a/packages/kbn-language-documentation/src/components/shared/documentation_content.tsx b/packages/kbn-language-documentation/src/components/shared/documentation_content.tsx
index 9e030aa0a19fa..20041940a9b7b 100644
--- a/packages/kbn-language-documentation/src/components/shared/documentation_content.tsx
+++ b/packages/kbn-language-documentation/src/components/shared/documentation_content.tsx
@@ -7,7 +7,8 @@
  * License v3.0 only", or the "Server Side Public License, v 1".
  */
 import React from 'react';
-import { EuiFlexGroup, EuiText } from '@elastic/eui';
+import { i18n } from '@kbn/i18n';
+import { EuiFlexGroup, EuiText, EuiBetaBadge } from '@elastic/eui';
 import type { LanguageDocumentationSections } from '../../types';
 
 import './documentation.scss';
@@ -18,7 +19,7 @@ interface DocumentationContentProps {
   filteredGroups?: Array<{
     label: string;
     description?: string;
-    options: Array<{ label: string; description?: JSX.Element | undefined }>;
+    options: Array<{ label: string; description?: JSX.Element | undefined; preview?: boolean }>;
   }>;
   sections?: LanguageDocumentationSections;
 }
@@ -76,6 +77,23 @@ function DocumentationContent({
                         }
                       }}
                     >
+                      {helpItem.preview && (
+                        <EuiBetaBadge
+                          className="documentation__techPreviewBadge"
+                          label={i18n.translate('languageDocumentation.technicalPreviewLabel', {
+                            defaultMessage: 'Technical Preview',
+                          })}
+                          size="s"
+                          color="subdued"
+                          tooltipContent={i18n.translate(
+                            'languageDocumentation.technicalPreviewTooltip',
+                            {
+                              defaultMessage:
+                                'This functionality is experimental and not supported. It may change or be removed at any time.',
+                            }
+                          )}
+                        />
+                      )}
                       {helpItem.description}
                     </article>
                   );
diff --git a/packages/kbn-language-documentation/src/sections/generated/aggregation_functions.tsx b/packages/kbn-language-documentation/src/sections/generated/aggregation_functions.tsx
index 14a824c3183ee..6fe761e489c04 100644
--- a/packages/kbn-language-documentation/src/sections/generated/aggregation_functions.tsx
+++ b/packages/kbn-language-documentation/src/sections/generated/aggregation_functions.tsx
@@ -29,6 +29,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.avg', {
         defaultMessage: 'AVG',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -59,6 +60,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.count', {
         defaultMessage: 'COUNT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -92,6 +94,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.count_distinct', {
         defaultMessage: 'COUNT_DISTINCT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -125,6 +128,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.max', {
         defaultMessage: 'MAX',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -155,6 +159,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.median', {
         defaultMessage: 'MEDIAN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -189,6 +194,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.median_absolute_deviation', {
         defaultMessage: 'MEDIAN_ABSOLUTE_DEVIATION',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -225,6 +231,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.min', {
         defaultMessage: 'MIN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -255,6 +262,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.percentile', {
         defaultMessage: 'PERCENTILE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -290,6 +298,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_centroid_agg', {
         defaultMessage: 'ST_CENTROID_AGG',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -323,6 +332,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.sum', {
         defaultMessage: 'SUM',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -353,6 +363,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.top', {
         defaultMessage: 'TOP',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -383,6 +394,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.values', {
         defaultMessage: 'VALUES',
       }),
+      preview: true,
       description: (
         <Markdown
           openLinksInNewTab
@@ -418,6 +430,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.weighted_avg', {
         defaultMessage: 'WEIGHTED_AVG',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
diff --git a/packages/kbn-language-documentation/src/sections/generated/scalar_functions.tsx b/packages/kbn-language-documentation/src/sections/generated/scalar_functions.tsx
index 8abd05f77959a..855dea656adac 100644
--- a/packages/kbn-language-documentation/src/sections/generated/scalar_functions.tsx
+++ b/packages/kbn-language-documentation/src/sections/generated/scalar_functions.tsx
@@ -29,6 +29,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.abs', {
         defaultMessage: 'ABS',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -59,6 +60,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.acos', {
         defaultMessage: 'ACOS',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -89,6 +91,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.asin', {
         defaultMessage: 'ASIN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -120,6 +123,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.atan', {
         defaultMessage: 'ATAN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -151,6 +155,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.atan2', {
         defaultMessage: 'ATAN2',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -185,6 +190,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.bucket', {
         defaultMessage: 'BUCKET',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -221,6 +227,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.case', {
         defaultMessage: 'CASE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -260,6 +267,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.cbrt', {
         defaultMessage: 'CBRT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -291,6 +299,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.ceil', {
         defaultMessage: 'CEIL',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -322,6 +331,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.cidr_match', {
         defaultMessage: 'CIDR_MATCH',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -356,6 +366,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.coalesce', {
         defaultMessage: 'COALESCE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -389,6 +400,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.concat', {
         defaultMessage: 'CONCAT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -423,6 +435,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.cos', {
         defaultMessage: 'COS',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -453,6 +466,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.cosh', {
         defaultMessage: 'COSH',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -483,6 +497,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.date_diff', {
         defaultMessage: 'DATE_DIFF',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -517,6 +532,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.date_extract', {
         defaultMessage: 'DATE_EXTRACT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -550,6 +566,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.date_format', {
         defaultMessage: 'DATE_FORMAT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -584,6 +601,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.date_parse', {
         defaultMessage: 'DATE_PARSE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -617,6 +635,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.date_trunc', {
         defaultMessage: 'DATE_TRUNC',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -651,6 +670,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.e', {
         defaultMessage: 'E',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -680,6 +700,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.ends_with', {
         defaultMessage: 'ENDS_WITH',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -714,6 +735,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.exp', {
         defaultMessage: 'EXP',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -744,6 +766,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.floor', {
         defaultMessage: 'FLOOR',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -780,6 +803,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.from_base64', {
         defaultMessage: 'FROM_BASE64',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -813,6 +837,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.greatest', {
         defaultMessage: 'GREATEST',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -848,6 +873,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.hypot', {
         defaultMessage: 'HYPOT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -882,6 +908,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.ip_prefix', {
         defaultMessage: 'IP_PREFIX',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -915,6 +942,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.least', {
         defaultMessage: 'LEAST',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -948,6 +976,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.left', {
         defaultMessage: 'LEFT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -981,6 +1010,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.length', {
         defaultMessage: 'LENGTH',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1015,6 +1045,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.locate', {
         defaultMessage: 'LOCATE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1050,6 +1081,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.log', {
         defaultMessage: 'LOG',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1082,6 +1114,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.log10', {
         defaultMessage: 'LOG10',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1117,6 +1150,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.ltrim', {
         defaultMessage: 'LTRIM',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1153,6 +1187,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.match', {
         defaultMessage: 'MATCH',
       }),
+      preview: true,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1189,6 +1224,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_append', {
         defaultMessage: 'MV_APPEND',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1218,6 +1254,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_avg', {
         defaultMessage: 'MV_AVG',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1251,6 +1288,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_concat', {
         defaultMessage: 'MV_CONCAT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1284,6 +1322,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_count', {
         defaultMessage: 'MV_COUNT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1317,6 +1356,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_dedupe', {
         defaultMessage: 'MV_DEDUPE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1351,6 +1391,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_first', {
         defaultMessage: 'MV_FIRST',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1386,6 +1427,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_last', {
         defaultMessage: 'MV_LAST',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1421,6 +1463,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_max', {
         defaultMessage: 'MV_MAX',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1454,6 +1497,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_median', {
         defaultMessage: 'MV_MEDIAN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1490,6 +1534,7 @@ export const functions = {
           defaultMessage: 'MV_MEDIAN_ABSOLUTE_DEVIATION',
         }
       ),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1526,6 +1571,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_min', {
         defaultMessage: 'MV_MIN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1559,6 +1605,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_percentile', {
         defaultMessage: 'MV_PERCENTILE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1592,6 +1639,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_pseries_weighted_sum', {
         defaultMessage: 'MV_PSERIES_WEIGHTED_SUM',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1626,6 +1674,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_slice', {
         defaultMessage: 'MV_SLICE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1661,6 +1710,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_sort', {
         defaultMessage: 'MV_SORT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1694,6 +1744,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_sum', {
         defaultMessage: 'MV_SUM',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1727,6 +1778,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.mv_zip', {
         defaultMessage: 'MV_ZIP',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1761,6 +1813,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.now', {
         defaultMessage: 'NOW',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1790,6 +1843,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.pi', {
         defaultMessage: 'PI',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1819,6 +1873,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.pow', {
         defaultMessage: 'POW',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1850,6 +1905,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.qstr', {
         defaultMessage: 'QSTR',
       }),
+      preview: true,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1883,6 +1939,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.repeat', {
         defaultMessage: 'REPEAT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1900,7 +1957,7 @@ export const functions = {
 
   \`\`\`
   ROW a = "Hello!"
-  | EVAL triple_a = REPEAT(a, 3);
+  | EVAL triple_a = REPEAT(a, 3)
   \`\`\`
   `,
               description:
@@ -1916,6 +1973,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.replace', {
         defaultMessage: 'REPLACE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1951,6 +2009,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.reverse', {
         defaultMessage: 'REVERSE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -1983,6 +2042,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.right', {
         defaultMessage: 'RIGHT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2019,6 +2079,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.round', {
         defaultMessage: 'ROUND',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2056,6 +2117,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.rtrim', {
         defaultMessage: 'RTRIM',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2092,6 +2154,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.signum', {
         defaultMessage: 'SIGNUM',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2126,6 +2189,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.sin', {
         defaultMessage: 'SIN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2156,6 +2220,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.sinh', {
         defaultMessage: 'SINH',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2186,6 +2251,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.space', {
         defaultMessage: 'SPACE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2218,6 +2284,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.split', {
         defaultMessage: 'SPLIT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2251,6 +2318,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.sqrt', {
         defaultMessage: 'SQRT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2282,6 +2350,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_contains', {
         defaultMessage: 'ST_CONTAINS',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2317,6 +2386,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_disjoint', {
         defaultMessage: 'ST_DISJOINT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2353,6 +2423,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_distance', {
         defaultMessage: 'ST_DISTANCE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2390,6 +2461,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_intersects', {
         defaultMessage: 'ST_INTERSECTS',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2427,6 +2499,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_within', {
         defaultMessage: 'ST_WITHIN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2462,6 +2535,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_x', {
         defaultMessage: 'ST_X',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2493,6 +2567,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.st_y', {
         defaultMessage: 'ST_Y',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2524,6 +2599,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.starts_with', {
         defaultMessage: 'STARTS_WITH',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2558,6 +2634,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.substring', {
         defaultMessage: 'SUBSTRING',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2592,6 +2669,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.tan', {
         defaultMessage: 'TAN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2622,6 +2700,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.tanh', {
         defaultMessage: 'TANH',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2652,6 +2731,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.tau', {
         defaultMessage: 'TAU',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2681,6 +2761,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_base64', {
         defaultMessage: 'TO_BASE64',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2714,6 +2795,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_boolean', {
         defaultMessage: 'TO_BOOLEAN',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2750,6 +2832,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_cartesianpoint', {
         defaultMessage: 'TO_CARTESIANPOINT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2785,6 +2868,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_cartesianshape', {
         defaultMessage: 'TO_CARTESIANSHAPE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2820,6 +2904,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_date_nanos', {
         defaultMessage: 'TO_DATE_NANOS',
       }),
+      preview: true,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2850,6 +2935,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_dateperiod', {
         defaultMessage: 'TO_DATEPERIOD',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2882,6 +2968,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_datetime', {
         defaultMessage: 'TO_DATETIME',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2918,6 +3005,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_degrees', {
         defaultMessage: 'TO_DEGREES',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2951,6 +3039,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_double', {
         defaultMessage: 'TO_DOUBLE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -2986,6 +3075,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_geopoint', {
         defaultMessage: 'TO_GEOPOINT',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3020,6 +3110,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_geoshape', {
         defaultMessage: 'TO_GEOSHAPE',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3054,6 +3145,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_integer', {
         defaultMessage: 'TO_INTEGER',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3090,6 +3182,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_ip', {
         defaultMessage: 'TO_IP',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3124,6 +3217,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_long', {
         defaultMessage: 'TO_LONG',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3159,6 +3253,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_lower', {
         defaultMessage: 'TO_LOWER',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3192,6 +3287,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_radians', {
         defaultMessage: 'TO_RADIANS',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3225,6 +3321,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_string', {
         defaultMessage: 'TO_STRING',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3258,6 +3355,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_timeduration', {
         defaultMessage: 'TO_TIMEDURATION',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3290,6 +3388,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_unsigned_long', {
         defaultMessage: 'TO_UNSIGNED_LONG',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3325,6 +3424,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_upper', {
         defaultMessage: 'TO_UPPER',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3358,6 +3458,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.to_version', {
         defaultMessage: 'TO_VERSION',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab
@@ -3390,6 +3491,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.trim', {
         defaultMessage: 'TRIM',
       }),
+      preview: false,
       description: (
         <Markdown
           openLinksInNewTab