Skip to content

Broken links in reference documentation #19194

@ChamikaUluwatta

Description

@ChamikaUluwatta

Describe the bug
Some links in the reference documentation are broken. The {security-api-url} AsciiDoc attribute generates URLs that don't resolve to the actual Javadoc location.

For example, in docs/module/ROOT/pages/servlet/oauth2/authorization-server/getting-started.adoc:

<7> An instance of {security-api-url}/org/springframework/security/oauth2/jwt/JwtDecoder.htmlJwtDecoder for decoding signed access tokens.

This creates: https://docs.spring.io/spring-security/site/docs/7.0.5/api//org/springframework/security/oauth2/jwt/JwtDecoder.html
But 7.0.5 doesn't exist under https://docs.spring.io/spring-security/site/docs — only 7.0.x does.

To Reproduce

  1. Go to https://docs.spring.io/spring-security/reference/servlet/oauth2/authorization-server/getting-started.html#oauth2AuthorizationServer-defining-required-components
  2. Click a Javadoc link like JwtDecoder (item 7)
  3. This navigates to https://docs.spring.io/spring-security/site/docs/7.0.5/api//org/springframework/security/oauth2/jwt/JwtDecoder.html and returns 404

Expected behavior
The link should resolve to an existing Javadoc page.

Additional notes

  • The URL contains a double slash: api//org/. The attribute security-api-url already ends with / and the AsciiDoc pattern adds another /.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions