Add canonical links to 2.8

_about/breaking-changes.md

@@ -3,6 +3,7 @@ layout: default
 title: Breaking changes
 nav_order: 5
 permalink: /breaking-changes/
+canonical_url: https://opensearch.org/docs/latest/breaking-changes/
 ---
 
 ## 1.x

_about/index.md

@@ -10,6 +10,7 @@ redirect_from:
   - /docs/opensearch/
   - /opensearch/
   - /opensearch/index/
+canonical_url: https://opensearch.org/docs/latest/about/
 ---
 
 {%- comment -%}The `/docs/opensearch/` redirect is specifically to support the UI links in OpenSearch Dashboards 1.0.0.{%- endcomment -%}

_about/intro.md

@@ -3,6 +3,7 @@ layout: default
 title: Intro to OpenSearch
 nav_order: 2
 permalink: /intro/
+canonical_url: https://opensearch.org/docs/latest/getting-started/intro/
 ---
 
 # Introduction to OpenSearch

_about/quickstart.md

@@ -5,6 +5,7 @@ nav_order: 3
 permalink: /quickstart/
 redirect_from: 
   - /opensearch/install/quickstart/
+canonical_url: https://opensearch.org/docs/latest/getting-started/quickstart/
 ---
 
 # Quickstart

_about/version-history.md

@@ -3,6 +3,7 @@ layout: default
 title: Version history
 nav_order: 4
 permalink: /version-history/
+canonical_url: https://opensearch.org/docs/latest/version-history/
 ---
 
 # Version history

_api-reference/analyze-apis/index.md

@@ -5,6 +5,7 @@ has_children: true
 nav_order: 7
 redirect_from:
   - /opensearch/rest-api/analyze-apis/
+canonical_url: https://opensearch.org/docs/latest/api-reference/analyze-apis/
 ---
 
 # Analyze API

_api-reference/analyze-apis/perform-text-analysis.md

@@ -4,6 +4,7 @@ title: Perform text analysis
 parent: Analyze API
 
 nav_order: 2
+canonical_url: https://opensearch.org/docs/latest/api-reference/analyze-apis/
 ---
 
 # Perform text analysis

_api-reference/analyze-apis/terminology.md

@@ -4,6 +4,7 @@ title: Analysis API Terminology
 parent: Analyze API
 
 nav_order: 1
+canonical_url: https://opensearch.org/docs/latest/api-reference/analyze-apis/terminology/
 ---
 
 # Terminology

_api-reference/cat/cat-aliases.md

@@ -7,6 +7,7 @@ redirect_from:
 
 nav_order: 1
 has_children: false
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-aliases/
 ---
 
 # CAT aliases

_api-reference/cat/cat-allocation.md

@@ -6,6 +6,7 @@ redirect_from:
 - /opensearch/rest-api/cat/cat-allocation/
 nav_order: 5
 has_children: false
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-allocation/
 ---
 
 # CAT allocation

_api-reference/cat/cat-cluster_manager.md

@@ -6,6 +6,7 @@ redirect_from:
  - /opensearch/rest-api/cat/cat-master/
 nav_order: 30
 has_children: false
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-cluster_manager/
 ---
 
 # CAT cluster_manager

_api-reference/cat/cat-count.md

@@ -7,6 +7,7 @@ has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-count/
 
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-count/
 ---
 
 # CAT count

_api-reference/cat/cat-field-data.md

@@ -6,6 +6,7 @@ nav_order: 15
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-field-data/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-field-data/
 ---
 
 # CAT fielddata

_api-reference/cat/cat-health.md

@@ -7,6 +7,7 @@ nav_order: 20
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-health/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-health/
 ---
 
 # CAT health

_api-reference/cat/cat-indices.md

@@ -6,6 +6,7 @@ nav_order: 25
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-indices/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-indices/
 ---
 
 # CAT indices

_api-reference/cat/cat-nodeattrs.md

@@ -6,6 +6,7 @@ nav_order: 35
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-nodeattrs/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-nodeattrs/
 ---
 
 # CAT nodeattrs

_api-reference/cat/cat-nodes.md

@@ -7,6 +7,7 @@ nav_order: 40
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-nodes/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/
 ---
 
 # CAT nodes

_api-reference/cat/cat-pending-tasks.md

@@ -7,6 +7,7 @@ nav_order: 45
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-pending-tasks/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-pending-tasks/
 ---
 
 # CAT pending tasks

_api-reference/cat/cat-plugins.md

@@ -7,6 +7,7 @@ nav_order: 50
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-plugins/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/
 ---
 
 # CAT plugins

_api-reference/cat/cat-recovery.md

@@ -7,6 +7,7 @@ nav_order: 50
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-recovery/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-recovery/
 ---
 
 # CAT recovery

_api-reference/cat/cat-repositories.md

@@ -7,6 +7,7 @@ nav_order: 52
 has_children: false
 redirect_from:
  - /opensearch/rest-api/cat/cat-repositories/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-repositories/
 ---
 
 # CAT repositories

_api-reference/cat/cat-segment-replication.md

@@ -4,6 +4,7 @@ title: CAT segment replication
 parent: CAT API
 nav_order: 53
 has_children: false
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-segment-replication/
 ---
 
 # CAT segment replication

_api-reference/cat/cat-segments.md

@@ -7,6 +7,7 @@ nav_order: 55
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-segments/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-segments/
 ---
 
 # CAT segments

_api-reference/cat/cat-shards.md

@@ -7,6 +7,7 @@ nav_order: 60
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-shards/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-shards/
 ---
 
 # CAT shards

_api-reference/cat/cat-snapshots.md

@@ -7,6 +7,7 @@ nav_order: 65
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-snapshots/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-snapshots/
 ---
 
 # CAT snapshots

_api-reference/cat/cat-tasks.md

@@ -7,6 +7,7 @@ nav_order: 70
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-tasks/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-tasks/
 ---
 
 # CAT tasks

_api-reference/cat/cat-templates.md

@@ -7,6 +7,7 @@ nav_order: 70
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-templates/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-templates/
 ---
 
 # CAT templates

_api-reference/cat/cat-thread-pool.md

@@ -6,6 +6,7 @@ nav_order: 75
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-thread-pool/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/cat-thread-pool/
 ---
 
 # CAT thread pool

_api-reference/cat/index.md

@@ -6,6 +6,7 @@ has_children: true
 redirect_from:
   - /opensearch/catapis/
   - /opensearch/rest-api/cat/index/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cat/index/
 ---
 
 # CAT API

_api-reference/cluster-api/cluster-allocation.md

@@ -6,6 +6,7 @@ parent: Cluster APIs
 has_children: false
 redirect_from:
  - /opensearch/rest-api/cluster-allocation/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-allocation/
 ---
 
 # Cluster allocation explain

_api-reference/cluster-api/cluster-awareness.md

@@ -7,6 +7,7 @@ has_children: false
 redirect_from:
   - /api-reference/cluster-awareness/
   - /opensearch/rest-api/cluster-awareness/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-awareness/
 ---
 
 # Cluster routing and awareness

_api-reference/cluster-api/cluster-decommission.md

@@ -7,6 +7,7 @@ has_children: false
 redirect_from: 
   - /api-reference/cluster-decommission/
   - /opensearch/rest-api/cluster-decommission/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-decommission/
 ---
 
 # Cluster decommission

_api-reference/cluster-api/cluster-health.md

@@ -7,6 +7,7 @@ has_children: false
 redirect_from: 
  - /api-reference/cluster-health/
  - /opensearch/rest-api/cluster-health/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-health/
 ---
 
 # Cluster health

_api-reference/cluster-api/cluster-settings.md

@@ -6,6 +6,7 @@ parent: Cluster APIs
 redirect_from:
   - /api-reference/cluster-settings/
   - /opensearch/rest-api/cluster-settings/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-settings/
 ---
 
 # Cluster settings

_api-reference/cluster-api/cluster-stats.md

@@ -7,6 +7,7 @@ has_children: false
 redirect_from:
   - /api-reference/cluster-stats/
   - /opensearch/rest-api/cluster-stats/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-stats/
 ---
 
 # Cluster stats

_api-reference/cluster-api/index.md

@@ -5,6 +5,7 @@ has_children: true
 nav_order: 15
 redirect_from:
   - /opensearch/api-reference/cluster-api/
+canonical_url: https://opensearch.org/docs/latest/api-reference/cluster-api/index/
 ---
 
 # Cluster APIs

_api-reference/common-parameters.md

@@ -4,6 +4,7 @@ title: Common REST Parameters
 nav_order: 93
 redirect_from:
   - /opensearch/common-parameters/
+canonical_url: https://opensearch.org/docs/latest/api-reference/common-parameters/
 ---
 
 # Common REST parameters

_api-reference/count.md

@@ -4,6 +4,7 @@ title: Count
 nav_order: 21
 redirect_from: 
  - /opensearch/rest-api/count/
+canonical_url: https://opensearch.org/docs/latest/api-reference/count/
 ---
 
 # Count

_api-reference/document-apis/bulk.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 20
 redirect_from:
  - /opensearch/rest-api/document-apis/bulk/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/bulk/
 ---
 
 # Bulk

_api-reference/document-apis/delete-by-query.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 40
 redirect_from: 
  - /opensearch/rest-api/document-apis/delete-by-query/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/delete-by-query/
 ---
 
 # Delete by query

_api-reference/document-apis/delete-document.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 15
 redirect_from: 
  - /opensearch/rest-api/document-apis/delete-document/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/delete-document/
 ---
 
 # Delete document

_api-reference/document-apis/get-documents.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 5
 redirect_from: 
  - /opensearch/rest-api/document-apis/get-documents/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/
 ---
 
 # Get document

_api-reference/document-apis/index-document.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 1
 redirect_from: 
  - /opensearch/rest-api/document-apis/index-document/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/index-document/
 ---
 
 # Index document

_api-reference/document-apis/index.md

@@ -5,6 +5,7 @@ has_children: true
 nav_order: 25
 redirect_from:
   - /opensearch/rest-api/document-apis/index/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/index/
 ---
 
 # Document APIs

_api-reference/document-apis/multi-get.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 30
 redirect_from: 
  - /opensearch/rest-api/document-apis/multi-get/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/multi-get/
 ---
 
 # Multi-get documents

_api-reference/document-apis/reindex.md

@@ -6,6 +6,7 @@ nav_order: 60
 redirect_from: 
   - /opensearch/reindex-data/
   - /opensearch/rest-api/document-apis/reindex/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/reindex/
 ---
 
 # Reindex document

_api-reference/document-apis/update-by-query.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 50
 redirect_from: 
  - /opensearch/rest-api/document-apis/update-by-query/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/update-by-query/
 ---
 
 # Update by query

_api-reference/document-apis/update-document.md

@@ -5,6 +5,7 @@ parent: Document APIs
 nav_order: 10
 redirect_from: 
  - /opensearch/rest-api/document-apis/update-document/
+canonical_url: https://opensearch.org/docs/latest/api-reference/document-apis/update-document/
 ---
 
 # Update document

_api-reference/explain.md

@@ -4,6 +4,7 @@ title: Explain
 nav_order: 30
 redirect_from: 
  - /opensearch/rest-api/explain/
+canonical_url: https://opensearch.org/docs/latest/api-reference/explain/
 ---
 
 # Explain

_api-reference/index-apis/alias.md

@@ -6,6 +6,7 @@ nav_order: 5
 redirect_from: 
  - /opensearch/rest-api/alias/
  - /api-reference/alias/
+canonical_url: https://opensearch.org/docs/latest/api-reference/index-apis/alias/
 ---
 
 # Alias