[docs] [chore] clean up after migrating some contribution, syntax guide (#2168)

leemthompo · web-flow · commit 730c8a959dcc · 2025-11-06T11:07:42.000+01:00
diff --git a/docs/_docset.yml b/docs/_docset.yml
@@ -29,23 +29,21 @@ toc:
   - file: index.md
   - hidden: 404.md
   - hidden: developer-notes.md
+  - hidden: contribute/cumulative-docs/index.md
+  - hidden: contribute/cumulative-docs/guidelines.md
+  - hidden: contribute/cumulative-docs/badge-placement.md
+  - hidden: contribute/cumulative-docs/example-scenarios.md
+  - hidden: contribute/cumulative-docs/reference.md
   - folder: contribute
     children:
       - file: index.md
-      - file: locally.md
-      - file: on-the-web.md
       - file: move.md
       - file: redirects.md
-      - folder: cumulative-docs
-        children:
-          - file: index.md
-          - hidden: guidelines.md
-          - hidden: badge-placement.md
-          - hidden: example-scenarios.md
-          - hidden: reference.md
       - file: branching-strategy.md
       - file: add-repo.md
       - file: release-new-version.md
+      - hidden: locally.md
+      - hidden: on-the-web.md
   - folder: building-blocks
     children:
       - file: index.md
diff --git a/docs/_redirects.yml b/docs/_redirects.yml
@@ -23,4 +23,4 @@ redirects:
           "yy": "bb"
   'testing/redirects/third-page.md':
     anchors:
-      'removed-anchor':
+      'removed-anchor':
diff --git a/docs/building-blocks/index.md b/docs/building-blocks/index.md
@@ -1,8 +1,8 @@
 ---
-navigation_title: Building blocks
+navigation_title: Core architecture concepts
 ---
 
-# Building blocks
+# Core architecture concepts and building blocks
 
 This section explains the core concepts and building blocks that make up the docs-builder architecture. Understanding these concepts will help you work effectively with distributed documentation and cross-repository linking.
 
diff --git a/docs/contribute/add-repo.md b/docs/contribute/add-repo.md
@@ -1,3 +1,7 @@
+---
+navigation_title: "Add a new repo to the docs"
+---
+
 # Add a new repository to the docs
 
 Elastic documentation is built from many assembled repositories using `docs-builder assemble`. Adding a new repository requires making the assembly process aware of its existence.
@@ -55,7 +59,7 @@ references:
 ```
 
 :::{tip}
-In this file, you can optionally specify custom branches to deploy docs from, depending on your preferred [branching strategy](/contribute/branching-strategy.md). You might want to change your branching strategy so you can have more control over when content added for a specific release is published.
+In this file, you can optionally specify custom branches to deploy docs from, depending on your preferred [branching strategy](branching-strategy.md). You might want to change your branching strategy so you can have more control over when content added for a specific release is published.
 :::
 
 Then, edit the [`navigation.yml`](https://github.com/elastic/docs-builder/blob/main/config/navigation.yml) file to add the repository to the navigation. Refer to [navigation.yml](../configure/site/navigation.md) for more information.
diff --git a/docs/contribute/branching-strategy.md b/docs/contribute/branching-strategy.md
@@ -1,5 +1,5 @@
 ---
-navigation_title: Choose a branching strategy
+navigation_title: Choose a repo branch strategy
 ---
 
 # Choose the docs branching strategy for a repository
diff --git a/docs/contribute/index.md b/docs/contribute/index.md
@@ -1,5 +1,21 @@
-# Elastic Docs contribution guide
+# How-to guides
 
-:::{note}
-👋 This page has moved to [elastic.co/docs](https://www.elastic.co/docs/contribute-docs/).
+:::{tip}
+Looking for contribution guides on how to write the docs? Refer to [Contribute to docs](https://www.elastic.co/docs/contribute-docs/) on the main Elastic documentation site.
 :::
+
+Use these guides for tasks like managing documentation files and folders, configuring repositories, and handling releases.
+
+## Manage files and links
+
+- [Move files and folders](move.md): Move files or folders and automatically update all links in the documentation.
+- [Manage redirects across doc sets](redirects.md): Set up redirects when moving or deleting pages to prevent broken links.
+
+## Repository management
+
+- [Add a new repository to the docs](add-repo.md): Add a new docs repository to the assembly process.
+- [Choose a branching strategy](branching-strategy.md): Choose the right docs branching strategy for your repository.
+
+## Release management
+
+- [Release a new documentation version](release-new-version.md): Update the docs site when a new version of the Elastic Stack or other versioned product is released.
diff --git a/docs/contribute/redirects.md b/docs/contribute/redirects.md
@@ -1,5 +1,5 @@
 ---
-navigation_title: "Redirects"
+navigation_title: "Set up redirects"
 ---
 
 # Manage redirects across doc sets
diff --git a/docs/contribute/release-new-version.md b/docs/contribute/release-new-version.md
@@ -1,3 +1,7 @@
+---
+navigation_title: Release a new docs version
+---
+
 # Release a new documentation version
 
 When a new version of the Elastic Stack (or another versioned product) is released, the docs site must be updated to recognize it. This process primarily involves updating version metadata in the shared site configuration.
diff --git a/docs/index.md b/docs/index.md
@@ -8,8 +8,8 @@ Elastic Docs V3 is our next-generation documentation platform designed to improv
 
 ## What do you want to do today?
 
-* [Contribute to Elastic documentation](./contribute/index.md)
-* [Learn about migration to Elastic Docs V3](./migration/index.md)
-* [Configure content sets in V3](./configure/index.md)
+* [Contribute to Elastic documentation](https://www.elastic.co/docs/contribute-docs/)
 * [Learn about V3 syntax](./syntax/index.md)
+* [Configure content sets in V3](./configure/index.md)
 * [Contribute to V3 (developer guide)](./development/index.md)
+* [Learn about migration to Elastic Docs V3](./migration/index.md)
diff --git a/docs/syntax/quick-ref.md b/docs/syntax/quick-ref.md
