Skip to content

feat: upgrade Hugo to 0.164.0 and replace hardcoded copy with positioning data#86

Open
trevor-vaughan wants to merge 1 commit into
mainfrom
fix/64-problem-statement
Open

feat: upgrade Hugo to 0.164.0 and replace hardcoded copy with positioning data#86
trevor-vaughan wants to merge 1 commit into
mainfrom
fix/64-problem-statement

Conversation

@trevor-vaughan

Copy link
Copy Markdown
Member

Hugo 0.164 required migrating deprecated config keys and template APIs.
Hardcoded homepage and getting-started copy was replaced with structured
data that templates and a new shortcode render from a single source.

  • Bump Hugo from 0.155.1 to 0.164.0 in Dockerfile, CI workflows, and Makefile
  • Migrate config: languageCode -> locale, languageName -> label,
    excludeFiles -> files syntax, caches.getjson -> caches.getresource,
    site.Data -> hugo.Data
  • Add data/positioning.yaml with problem, audience, maturity, alternatives,
    and feature card definitions
  • Rewrite homepage and getting-started to render from positioning data
  • Add positioning shortcode for embedding sections in docs pages
  • Add Makefile prerequisite checks for Go, Node, and Hugo versions
  • Patch @thulite/doks-core for SCSS @extend and hugo.Data template fixes
  • Add sass-embedded with postinstall dart-sass symlink
  • Override doks-core partials (baseof, stylesheet, favicons, opengraph)
  • Add jsconfig.json for asset path resolution
  • Rename CI workflow to "Build", add version comments to pinned action refs
  • Require Node.js >= 22 (was >= 20.11.0)

Fixes: #64

Signed-off-by: Trevor Vaughan tvaughan@redhat.com

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

CRAP Load Analysis

No Go code changes detected in this PR. No CRAP impact.

@trevor-vaughan

Copy link
Copy Markdown
Member Author

The repo was pretty far out of date so this turned into a bit of an upgrade refactor to get things up to date.

…ning data

Hugo 0.164 required migrating deprecated config keys and template APIs.
Hardcoded homepage and getting-started copy was replaced with structured
data that templates and a new shortcode render from a single source.

- Bump Hugo from 0.155.1 to 0.164.0 in Dockerfile, CI workflows, and Makefile
- Migrate config: `languageCode` -> `locale`, `languageName` -> `label`,
  `excludeFiles` -> `files` syntax, `caches.getjson` -> `caches.getresource`,
  `site.Data` -> `hugo.Data`
- Add data/positioning.yaml with problem, audience, maturity, alternatives,
  and feature card definitions
- Rewrite homepage and getting-started to render from positioning data
- Add positioning shortcode for embedding sections in docs pages
- Add Makefile prerequisite checks for Go, Node, and Hugo versions
- Patch @thulite/doks-core for SCSS `@extend` and `hugo.Data` template fixes
- Add sass-embedded with postinstall dart-sass symlink
- Override doks-core partials (baseof, stylesheet, favicons, opengraph)
- Add jsconfig.json for asset path resolution
- Rename CI workflow to "Build", add version comments to pinned action refs
- Require Node.js >= 22 (was >= 20.11.0)

Fixes: #64

Assisted-by: Claude Opus 4.6
Signed-off-by: Trevor Vaughan <tvaughan@redhat.com>
@trevor-vaughan trevor-vaughan force-pushed the fix/64-problem-statement branch from 84edf1c to 11d688e Compare July 8, 2026 15:21
@trevor-vaughan trevor-vaughan marked this pull request as ready for review July 8, 2026 15:30
@trevor-vaughan trevor-vaughan requested a review from a team as a code owner July 8, 2026 15:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Getting Started: the page never states what problem the tool solves or who it is for

1 participant