Skip to content

[Internal]: Broken links for Kibana 9.x versions #3903

@agusruidiazgd

Description

@agusruidiazgd

Description

Some documentation links displayed to users when they lack privileges in Kibana 9.1 and 9.2 are broken. The same links work correctly in main and 8.x.

When:
Observed in Kibana 9.1 and 9.2. Working as expected in main

Why:
Links are generated dynamically with the following logic:

const url = `${ELASTIC_WEBSITE_URL}guide/en/${guidePath}/${DOC_LINK_VERSION}/${docPath}`;

In main, the DOC_LINK_VERSION value is current, which correctly redirects to valid pages such as:

https://www.elastic.co/guide/en/security/current/detections-permissions-section.html
Valid redirection

https://www.elastic.co/guide/en/security/current/sec-requirements.html
Valid redirection

In contrast, for versions 9.1 and 9.2, the DOC_LINK_VERSION value is 9.x, resulting in broken links like:

https://www.elastic.co/guide/en/security/9.2/detections-permissions-section.html

https://www.elastic.co/guide/en/security/9.2/sec-requirements.html

It seems the documentation structure may have changed, causing versioned URLs (e.g., 9.x) to break while current remains valid

Resources

Related SDH: elastic/sdh-security-team#1488

Which documentation set does this change impact?

Elastic On-Prem and Cloud (all)

Feature differences

The issue occurs in both ESS and Serverless as the documentation link generation logic is shared. There are no differences between deployment methods.

What release is this request related to?

N/A

Serverless release

Around the next patch releases

Collaboration model

The documentation team

Point of contact.

Main contact: @agusruidiazgd

Stakeholders: @elastic/security-solution

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions