Repo: Update Hugo versions
- Dominant language
- HTML
- Stars
- 3
- Forks
- 5
- Avg merge
- 2d 7h
- Merged PRs (30d)
- 8
Description
The website can be built:
- by contributors on their local system
- by Continuous Integration workflows
- by the FreeCAD servers
Luckily, all they need is the single Hugo binary in the [standard](https://gohugo.io/installation/linux/) edition.
Sharing the same version is thus pretty easy. The version currently used is documented in a few places (e.g. ReadMe, web docs, etc).
The version choice is done "manually" for now, i.e. a maintainer updates all version strings after they have checked everything works with the new version.
The Hugo team releases about 10 to 20 versions (plus patch releases) every year (e.g. 0.110-0.121 for 2023, 0.122-0.140 for 2024, 0.141-0.154 for 2025, etc). Their [deprecation policy](https://gohugo.io/troubleshooting/deprecation) is pretty consistently applied. New versions seldom have breaking changes, but are most often improvements to existing features, speed or templates, and security updates. Major architecture changes are no tied to specific release numbers (e.g. 0.146 for template overhaul).
Given that, it sounds reasonable to update Hugo versions for every tenth version, given it is not a "major" architecture reshuffle, in which case we can wait a few more versions for stabilization. Next one would be 0.170 and then 0.180, that is about every 6 months.
Open questions:
- do we keep updating manually, as it is fairly easy for now (5 strings to update)?
- do we set up a container like Docker or similar, and encourage contributors to use that?
- do we set up some automated process to update the version in the servers as well?
- if and when the website base is used more broadly (e.g. full user documentation), do we set up some "dummy" environment for automated testing with all features used, so we can detect before-hand any rendering issues a new version could bring (i.e. instead of randomly founding it out)?
- TBD
Contributor guide
Research direction
Start by locating the five Hugo version strings mentioned in the README, web documentation, CI workflows, and FreeCAD server setup. Review how contributors build the website and how CI and servers select Hugo; done means an agreed update process keeps the chosen version consistent across all environments and addresses the listed automation questions.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- hugo
- Domain
- build-system, web-dev
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100