Merge branch 'main' into add-new-repo-docs

Author: theletterf

docs/syntax/applies.md

@@ -184,9 +184,9 @@ There are 3 typical scenarios to start from:
       stack: ga
       serverless: ga
     products:
-      -id: kibana
-      -id: elasticsearch
-      -id: elastic-stack
+      - id: kibana
+      - id: elasticsearch
+      - id: elastic-stack
     ---
     ```
 
@@ -201,10 +201,10 @@ There are 3 typical scenarios to start from:
         ece: ga
         eck: ga
     products:
-      -id: cloud-serverless
-      -id: cloud-hosted
-      -id: cloud-enterprise
-      -id: cloud-kubernetes
+      - id: cloud-serverless
+      - id: cloud-hosted
+      - id: cloud-enterprise
+      - id: cloud-kubernetes
     ---
     ```
 
@@ -215,7 +215,7 @@ There are 3 typical scenarios to start from:
     applies_to:
       product: ga
     products:
-      -id: edot-collector
+      - id: edot-collector
     ---
     ```
 
@@ -363,4 +363,4 @@ applies_to:
   product:
 ---
 ```
-This allows you to annotate various facets as defined in [](../migration/versioning.md)
+This allows you to annotate various facets as defined in [](../migration/versioning.md)

docs/testing/req.md

@@ -1,5 +1,38 @@
+---
+applies_to:
+  stack: ga 9.1
+---
+
 # Requirements
 
+Current version: **9.0.0**
+
+| `applies_to`                               | result                               |
+|--------------------------------------------|--------------------------------------|
+| `` {applies_to}`stack: preview` ``         | {applies_to}`stack: preview`         |
+| `` {applies_to}`stack: preview 8.18` ``    | {applies_to}`stack: preview 8.18`    |
+| `` {applies_to}`stack: preview 9.0` ``     | {applies_to}`stack: preview 9.0`     |
+| `` {applies_to}`stack: preview 9.1` ``     | {applies_to}`stack: preview 9.1`     |
+| `` {applies_to}`stack: ga` ``              | {applies_to}`stack: ga`              |
+| `` {applies_to}`stack: ga 8.18` ``         | {applies_to}`stack: ga 8.18`         |
+| `` {applies_to}`stack: ga 9.0` ``          | {applies_to}`stack: ga 9.0`          |
+| `` {applies_to}`stack: ga 9.1` ``          | {applies_to}`stack: ga 9.1`          |
+| `` {applies_to}`stack: beta` ``            | {applies_to}`stack: beta`            |
+| `` {applies_to}`stack: beta 8.18` ``       | {applies_to}`stack: beta 8.18`       |
+| `` {applies_to}`stack: beta 9.0` ``        | {applies_to}`stack: beta 9.0`        |
+| `` {applies_to}`stack: beta 9.1` ``        | {applies_to}`stack: beta 9.1`        |
+| `` {applies_to}`stack: deprecated` ``      | {applies_to}`stack: deprecated`      |
+| `` {applies_to}`stack: deprecated 8.18` `` | {applies_to}`stack: deprecated 8.18` |
+| `` {applies_to}`stack: deprecated 9.0` ``  | {applies_to}`stack: deprecated 9.0`  |
+| `` {applies_to}`stack: deprecated 9.1` ``  | {applies_to}`stack: deprecated 9.1`  |
+| `` {applies_to}`stack: removed` ``         | {applies_to}`stack: removed`         |
+| `` {applies_to}`stack: removed 8.18` ``    | {applies_to}`stack: removed 8.18`    |
+| `` {applies_to}`stack: removed 9.0` ``     | {applies_to}`stack: removed 9.0`     |
+| `` {applies_to}`stack: removed 9.1` ``     | {applies_to}`stack: removed 9.1`     |
+
+{applies_to}`stack: deprecated 9.1, removed 9.4`
+
+
 To follow this tutorial you will need to install the following components:
 
 - An installation of Elasticsearch, based on our hosted [Elastic Cloud](https://www.elastic.co/cloud) service (which includes a free trial period), or a self-hosted service that you run on your own computer. See the Install Elasticsearch section above for installation instructions.
@@ -9,4 +42,4 @@ The tutorial assumes that you have no previous knowledge of Elasticsearch or gen
 
 - Python development
 - The [Flask](https://flask.palletsprojects.com/) web framework for Python.
-- The command prompt or terminal application in your operating system.
+- The command prompt or terminal application in your operating system.

docs/versions/content-patterns.md

@@ -35,7 +35,7 @@ See [Versions and lifecycle states](/versions/index.md#versions-and-lifecycle-st
 stack: ga 9.1
 deployment:
   eck: ga 9.0
-  ece: discontinued 9.2.0
+  ece: removed 9.2.0
   self: unavailable 9.3.0
 ```
 

src/Elastic.Documentation.Configuration/Assembler/VersionEntry.cs

@@ -13,7 +13,4 @@ public record VersionEntry
 
 	[YamlMember(Alias = "current")]
 	public string? Current { get; set; }
-
-	[YamlMember(Alias = "legacy_versions")]
-	public IReadOnlyList<string> LegacyVersions { get; set; } = [];
 }

src/Elastic.Documentation.Site/Assets/main.ts

@@ -11,6 +11,7 @@ import 'htmx-ext-head-support'
 import 'htmx-ext-preload'
 import 'htmx.org'
 import { $, $$ } from 'select-dom'
+import tippy from 'tippy.js'
 import { UAParser } from 'ua-parser-js'
 
 const { getOS } = new UAParser()
@@ -24,6 +25,9 @@ document.addEventListener('htmx:load', function () {
     initSmoothScroll()
     openDetailsWithAnchor()
     initDismissibleBanner()
+    tippy('[data-tippy-content]:not([data-tippy-content=""])', {
+        delay: [400, 100],
+    })
 })
 
 // Don't remove style tags because they are used by the elastic global nav.

src/Elastic.Documentation.Site/Assets/styles.css

@@ -17,6 +17,7 @@
 @import './archive.css';
 @import './markdown/stepper.css';
 @import './api-docs.css';
+@import 'tippy.js/dist/tippy.css';
 
 :root {
 	--outline-size: max(2px, 0.08em);
@@ -162,6 +163,7 @@
 		}
 
 		.applicable-info {
+			cursor: default;
 			padding: calc(var(--spacing) * 0.5);
 			padding-left: calc(var(--spacing) * 2);
 			padding-right: calc(var(--spacing) * 2);
@@ -173,6 +175,9 @@
 			background-color: var(--color-white);
 			border: 1px solid var(--color-grey-20);
 			font-weight: normal;
+			&[data-tippy-content]:not([data-tippy-content='']) {
+				cursor: help;
+			}
 		}
 		.applicable-version {
 			font-weight: bold;

src/Elastic.Documentation.Site/Assets/web-components/VersionDropdown.tsx

@@ -172,8 +172,8 @@ const VersionDropdown = ({
                               renderItem: () => (
                                   <EuiPanel paddingSize="s" hasShadow={false}>
                                       <EuiText size="xs" color="subdued">
-                                          This page was fully migrated to the
-                                          current version.
+                                          There are no other versions available
+                                          for this page.
                                       </EuiText>
                                   </EuiPanel>
                               ),

src/Elastic.Documentation.Site/package-lock.json

@@ -41,7 +41,7 @@
     "moment": "2.30.1",
     "parcel": "2.15.4",
     "postcss": "8.5.6",
-    "postcss-import": "16.1.0",
+    "postcss-import": "16.1.1",
     "prettier": "3.5.3",
     "prettier-plugin-tailwindcss": "0.6.13",
     "react": "18.3.1",
@@ -59,6 +59,7 @@
     "htmx.org": "2.0.5",
     "select-dom": "9.3.1",
     "tailwindcss": "4.1.10",
+    "tippy.js": "6.3.7",
     "ua-parser-js": "2.0.3"
   }
 }

src/Elastic.Documentation.Site/package.json

@@ -27,7 +27,7 @@ public DetectionRuleOverviewFile(IFileInfo sourceFile, IDirectoryInfo rootPath,
 
 	protected override Task<MarkdownDocument> GetMinimalParseDocumentAsync(Cancel ctx)
 	{
-		Title = "Detection Rules Overview";
+		Title = "Prebuilt detection rules reference";
 		var markdown = GetMarkdown();
 		var document = MarkdownParser.MinimalParseStringAsync(markdown, SourceFile, null);
 		return Task.FromResult(document);