Legacy URL mappings
This legacy-url-mappings.yml
file manages legacy URL patterns for Elastic documentation, mapping the path of each legacy build URL to a list of documentation versions. It ensures that users can easily find previous versions of our documentation.
This example maps documentation that references `elastic.co/guide/en/elasticsearch/reference/ to Elastic Stack versioned URL paths:
en/elasticsearch/reference/:
product: elastic-stack
legacy_versions: *stack
stack anchor
- Defines a reusable list of version strings for "stack" projects, e.g., [ '9.0+', '8.18', ... ].
mappings
-
A YAML mapping where each key is a legacy documentation URL path (like
en/apm/agent/java/
), and each value is a mapping with:product
: Specifies the product or project type (e.g.,elastic-stack
,eck
,ece
,self-managed
, etc.). Products must be defined inproducts.yml
. See products.yml for more information.legacy_versions
: A list of version strings that correspond to the available asciidoc pages.