crossplane / crossplane/docs

`hugo server` fails local build with many `REF_NOT_FOUND`

Open
#1,136 2 comments 0 reactions 0 assignees View on GitHub
bug
Dominant language
SCSS
Stars
60
Forks
163
Avg merge
15h 20m
Merged PRs (30d)
9

Description

### What's Wrong?

Running `hugo server` locally reports a number of issues for `REF_NOT_FOUND`. This was discovered during the v2.4 release process https://github.com/crossplane/docs/issues/1135, but it appears to be reproducible on main before the v2.4 release also.

Errors:
```
ERROR [en] REF_NOT_FOUND: Ref "/latest/packages": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/cli/master/get-started/get-started-with-control-plane-projects.md:131:23": page not found
ERROR [en] REF_NOT_FOUND: Ref "/latest/packages/configurations/": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/cli/master/get-started/get-started-with-control-plane-projects.md:1:1": page not found
ERROR [en] REF_NOT_FOUND: Ref "/latest/packages": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/cli/v2.3/get-started/get-started-with-control-plane-projects.md:131:23": page not found
ERROR [en] REF_NOT_FOUND: Ref "/latest/packages": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/cli/v2.4/get-started/get-started-with-control-plane-projects.md:131:23": page not found
ERROR [en] REF_NOT_FOUND: Ref "/latest/packages/configurations/": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/cli/v2.3/get-started/get-started-with-control-plane-projects.md:1:1": page not found
ERROR [en] REF_NOT_FOUND: Ref "/latest/packages/configurations/": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/cli/v2.4/get-started/get-started-with-control-plane-projects.md:1:1": page not found
ERROR [en] REF_NOT_FOUND: Ref "/cli/latest/get-started/get-started-with-control-plane-projects": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/master/get-started/get-started-with-control-plane-projects.md:10:25": page not found
ERROR [en] REF_NOT_FOUND: Ref "/cli/latest/get-started/get-started-with-control-plane-projects": "/Users/jared/dev/go/src/github.com/crossplane/docs/content/v2.3/get-started/get-started-with-control-plane-projects.md:10:25": page not found

ERROR error building site: logged 8 error(s)
```

They all seem to be related to links with `/latest/` either to or from the CLI docs.

`hugo version` output:
```
hugo v0.162.1-bba860e3eda3091efe8c6d1a96bc49a29ad2d5f6+extended darwin/arm64 BuildDate=2026-05-28T17:40:44Z VendorInfo=gohugoio
```

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.