Merge branch 'main' into leemthompo/put-contribution-sections-at-bottom-of-nav

Author: reakaleek

.github/actions/bootstrap/action.yml

@@ -38,7 +38,7 @@ runs:
         echo "full-version=${REPO_VERSION}" >> $GITHUB_OUTPUT
         echo "major-version=$(echo ${REPO_VERSION} | cut -d"." -f1)" >> $GITHUB_OUTPUT
         
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@v6
       with:
         cache: npm
         cache-dependency-path: src/Elastic.Documentation.Site/package-lock.json

.github/workflows/ci.yml

@@ -77,7 +77,7 @@ jobs:
     steps:
       - uses: actions/checkout@v5
 
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
           cache: npm
           cache-dependency-path: src/Elastic.Documentation.Site/package-lock.json

.github/workflows/preview-build.yml

@@ -452,6 +452,10 @@ jobs:
           && (steps.docs-build.outputs.skip != 'true' || steps.internal-docs-build.outputs.skip != 'true')
           && steps.deployment.outputs.result
           && (steps.docs-build.outcome == 'success' || steps.internal-docs-build.outcome == 'success')
+        env:
+          # https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-retries.html#cli-usage-retries-configure
+          AWS_RETRY_MODE: standard
+          AWS_MAX_ATTEMPTS: 6
         run: |
           aws s3 sync .artifacts/docs/html "s3://elastic-docs-v3-website-preview${PATH_PREFIX}" --delete --no-follow-symlinks
           aws cloudfront create-invalidation \

config/navigation.yml

@@ -573,10 +573,10 @@ toc:
                 path_prefix: reference/ecs/logging/ruby
                 # Children include the entire AsciiDoc book
 
-      # Data analysis
-      # https://github.com/elastic/docs-content/blob/main/reference/data-analysis/toc.yml
-      - toc: docs-content://reference/data-analysis
-        path_prefix: reference/data-analysis
+      # Machine learning (FKA Data analysis)
+      # https://github.com/elastic/docs-content/blob/main/reference/machine-learning/toc.yml
+      - toc: docs-content://reference/machine-learning
+        path_prefix: reference/machine-learning
 
       # Search UI
       # https://github.com/elastic/search-ui/blob/main/docs/reference/toc.yml

config/versions.yml

@@ -50,7 +50,7 @@ versioning_systems:
     current: 1.55.1
   apm-agent-node:
     base: 4.0
-    current: 4.14.0
+    current: 4.15.0
   apm-agent-php:
     base: 1.0
     current: 1.15.1

docs/cli/assembler/assembler-index.md

@@ -44,6 +44,9 @@ docs-builder assembler index [options...] [-h|--help] [--version]
 `--index-name-prefix` `<string>`
 :   The prefix for the computed index/alias names. Defaults:   semantic-docs (optional)
 
+`--force-reindex` `<bool?>`
+:   Force reindex strategy to semantic index, by default, we multiplex writes if the semantic index does not exist yet (optional)
+
 `--buffer-size` `<int?>`
 :   The number of documents to send to ES as part of the bulk. Defaults:   100 (optional)
 

docs/cli/docset/index-command.md

@@ -40,6 +40,9 @@ docs-builder index [options...] [-h|--help] [--version]
 `--index-name-prefix` `<string>`
 :   The prefix for the computed index/alias names. Defaults:   semantic-docs (optional)
 
+`--force-reindex` `<bool?>`
+:   Force reindex strategy to semantic index, by default, we multiplex writes if the semantic index does not exist yet (optional)
+
 `--buffer-size` `<int?>`
 :   The number of documents to send to ES as part of the bulk. Defaults:   100 (optional)
 

docs/syntax/frontmatter.md

@@ -15,13 +15,16 @@ applies_to: <3>
 products: <4>
   - id: apm-agent
   - id: edot-sdk
+sub: <5>
+  key: value 
 ---
 ```
 
 1. [`navigation_title`](#navigation-title)
 2. [`description`](#description)
 3. [`applies_to`](#applies-to)
 4. [`products`](#products)
+5. [`sub`](#subs)
 
 ## Navigation Title
 
@@ -83,3 +86,7 @@ The products frontmatter is a list of objects, each object has an `id` field.
 | `search-ui`                                 | Search UI                                     |
 | `security`                                  | Elastic Security                              |
 | `winlogbeat`                                | Winlogbeat                                    |
+
+## Subs
+
+Use the `sub` field to define local substitutions. Refer to [Substitutions](substitutions.md) for more information.

docs/syntax/images.md

@@ -19,7 +19,6 @@ If a page uses an image that exists outside the folder that contains the `toc.ym
 
 ![APM](/syntax/images/apm.png)
 
-
 Or, use the `image` directive.
 
 ```markdown
@@ -34,12 +33,41 @@ Or, use the `image` directive.
 :width: 250px
 :::
 
+### Image centering
+
+Images that are not full width are automatically centered within their container. This is particularly useful when you specify a width constraint:
+
+```markdown
+:::{image} /syntax/images/apm.png
+:alt: APM Logo
+:width: 400px
+:::
+```
+
+:::{image} /syntax/images/apm.png
+:alt: APM Logo
+:width: 400px
+:::
+
+The image above is centered because it has a width of 400px, which is less than the full container width.
+
+Note that images nested within other content (like lists or admonitions) are not centered:
+
+- First item in the list
+- Second item with an image:
+
+  :::{image} /syntax/images/apm.png
+  :alt: APM Logo in list
+  :width: 400px
+  :::
+
+- Third item in the list
+
 ## Screenshots
 
 Screenshots are images displayed with a box-shadow. Define a screenshot by adding the `:screenshot:` attribute to a block-level image directive.
 
 ```markdown
-
 :::{image} /syntax/images/apm.png
 :screenshot:
 :::
@@ -57,7 +85,6 @@ Here is the same image used inline ![Elasticsearch](/syntax/images/observability
 
 Here is the same image used inline ![Elasticsearch](/syntax/images/observability.png "elasticsearch =50%x50%")
 
-
 ### Inline image titles
 
 Titles are optional making this the minimal syntax required:
@@ -74,7 +101,6 @@ For inline images, the alt text always overrides any title specified in the Mark
 
 ![Elasticsearch](/syntax/images/observability.png "Different title =50%x50%")
 
-
 ### Inline image sizing
 
 Image sizing is specified through the title argument. You can specify just the size without needing to provide a redundant title:
@@ -99,24 +125,24 @@ If `H` is omitted `W` is used as the height as well.
 When specifying just the size without a title, no space is required before the `=` sign. When combining a title with sizing, a space is required before the `=`:
 
 ```markdown
-![alt](img.png "=50%")              <!-- Just size, no space needed -->
-![alt](img.png "My Title =50%")    <!-- With title, space required -->
+![alt](img.png "=50%") <!-- Just size, no space needed -->
+![alt](img.png "My Title =50%") <!-- With title, space required -->
 ```
 
-
-
-### SVG 
+### SVG
 
 ```markdown
 ![Elasticsearch](/syntax/images/alerts.svg)
 ```
+
 ![Elasticsearch](/syntax/images/alerts.svg)
 
 ### GIF
 
 ```markdown
 ![Elasticsearch](/syntax/images/timeslider.gif)
 ```
+
 ![Elasticsearch](/syntax/images/timeslider.gif)
 
 ## Asciidoc syntax
@@ -147,11 +173,14 @@ The image carousel directive builds upon the image directive.
 
 :::{image} images/applies.png
 :alt: Second image description
+
 ### Title is optional - alt text will be used as title if not specified
+
 :::
 
 ::::
 ```
+
 ::::{carousel}
 
 :id: nested-carousel-example

docs/syntax/substitutions.md

@@ -18,7 +18,7 @@ In both cases the yaml to define them is as followed:
 
 
 ```yaml
-subs:
+sub:
   key: value
   another-var: Another Value
 ```
@@ -222,7 +222,7 @@ Regular inline code (without the `{subs}` role) will not process substitutions a
 
 ## Products
 
-Product substitutions use `products.yml` to determine what will be displayed. Use the product's key to get its display name.
+Product substitutions use [`products.yml`](https://github.com/elastic/docs-builder/blob/main/config/products.yml) to determine what will be displayed. Use the product's key to get its display name.
 
 ```yaml 
 # products.yml