Skip to content

[NFR]: The nimbus dialect emits relative page links that nimbus cannot validate #11

Description

@niden

Summary

Dialect::nimbus() writes cross-page links in relative form (../phalcon_di/). The nimbus link rule skips every relative link instead of resolving it, so all 1009 cross-links of the generated API pages are excluded from validation, and nimbus-docs lint fails the build on each one.

The links themselves work. This is not a broken site: it is a lost check.

Evidence

The page renders the relative form, and the target resolves:

GET /5.20/api/phalcon_logger/   200   href="../phalcon_factory/#factoryabstractconfigfactory"
GET /5.20/api/phalcon_factory/  200
GET /6.0/api/phalcon_factory/   200

nimbus-docs lint reports the links as errors:

src/content/docs-5.20/api/phalcon_logger.mdx:301:3  error  nimbus/internal-link
  relative link "../phalcon_factory/#factoryabstractconfigfactory" —
  internal docs links should be root-relative (e.g. /foo).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

  • Status
    Implemented

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions