`hugo server` fails local build with many `REF_NOT_FOUND`
- 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.