Introduce IUriEnvironmentResolver to resolve crosslinks based on deployment environment

[Mpdreamz]

In assembler.yaml:

environments:
  production:
    uri: https://elastic.co
    path_prefix: docs
  staging:
    uri: https://staging-website.elastic.co
    path_prefix: docs
  preview:
    uri: https://docs-v3-preview.elastic.dev
    path_prefix:

Allows --environment <env> to be passed to docs-assembler repo build-all

Based on the environment cross links are written using the configured uri and environment prefix.

Repositories can also set a path_prefix e.g

references:
  apm-agent-android:
    path_prefix: reference/android
  apm-agent-dotnet:
  apm-agent-go:
  apm-agent-ios:
  apm-agent-java:
  apm-agent-nodejs:
    skip: true

All crosslinks to apm-agent-android:// in production would therefor resolve to

https://elastic.co/docs/reference/android/

[Copilot]

Pull Request Overview

This PR introduces support for resolving crosslinks based on the deployment environment by adding the IUriEnvironmentResolver interface and new implementations. Key changes include:

• Adding a new PublishEnvironmentUriResolver class that implements IUriEnvironmentResolver.
• Updating configuration (AssemblyConfiguration and assembler.yml) to support multiple environments.
• Modifying command-line commands, crosslink resolution, and tests to pass and use the environment parameter.

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/docs-assembler/Building/PublishEnvironmentUriResolver.cs	Introduces the resolver class that selects the appropriate URI based on the environment.
src/Elastic.Markdown/CrossLinks/IUriEnvironmentResolver.cs	Adds the IUriEnvironmentResolver interface and the PreviewEnvironmentUriResolver implementation.
src/docs-assembler/Configuration/AssemblyConfiguration.cs	Adds environment configuration support and YAML serialization for PublishEnvironment.
src/docs-assembler/assembler.yml	Defines environment configurations (production, staging, preview).
src/docs-assembler/Cli/RepositoryCommands.cs	Adds an environment parameter and integrates it into the build process.
src/Elastic.Markdown/CrossLinks/CrossLinkResolver.cs	Updates dependency injection to use the new resolver and removes hardcoded branch logic.
src/docs-assembler/Building/AssemblerBuilder.cs	Adjusts BuildAllAsync to accept an environment parameter and passes it to the resolver.
tests/Elastic.Markdown.Tests/TestCrossLinkResolver.cs	Updates tests to use the injected resolver.