kubernetes / website

Kubernetes website and documentation repo:
https://kubernetes.io
Creative Commons Attribution 4.0 International
4.5k stars 14.45k forks source link

Glossary entries with invalid front matter dates #48752

Open sreeram-venkitesh opened 3 hours ago

sreeram-venkitesh commented 3 hours ago

This is a Bug Report

Problem:

Hugo v0.135.0 throws ERROR the "date" front matter field is not a parsable date in a bunch of places (example) when running make serve. A change to the date validation was shipped in the v0.135.0 release which can throw an error when the date in the frontmatter is of a wrong format. I tested this with Hugo v0.134.3 and this error is not thrown.

Proposed Solution:

Remove date from the glossary entries since we don't need the date in the frontmatter for glossary entries. This was discussed here in Slack.

CC: @sftim

sreeram-venkitesh commented 2 hours ago

Here's the full error message I got when trying to run make serve with Hugo v0.135.0

❯ make serve
hugo server --buildFuture --environment development
Watching for changes in /Users/sreeram/OSS/kube/kubernetes-website/{archetypes,assets,content,data,layouts,package.json,postcss.config.js,static,themes}
Watching for config changes in /Users/sreeram/OSS/kube/kubernetes-website/hugo.toml, /Users/sreeram/OSS/kube/kubernetes-website/themes/docsy/config.toml, /Users/sreeram/OSS/kube/kubernetes-website/go.mod
Start building sites …
hugo v0.138.0+extended+withdeploy darwin/amd64 BuildDate=2024-11-06T11:22:34Z VendorInfo=brew

ERROR the "published" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/en/blog/_posts/2018-01-00-Reporting-Errors-Using-Kubernetes-Events.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/zh-cn/blog/_posts/2019-12-09-kubernetes-1.17-release-announcement.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/id/docs/reference/glossary/name.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/id/docs/reference/glossary/uid.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/ko/docs/reference/glossary/object.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/container.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/cri.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/deployment.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/docker.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/etcd.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/kube-proxy.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/kubelet.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/label.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/node.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/pod.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/selector.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/service.md
ERROR the "date" front matter field is not a parsable date: see /Users/sreeram/OSS/kube/kubernetes-website/content/vi/docs/reference/glossary/taint.md
WARN  deprecated: resources.ToCSS was deprecated in Hugo v0.128.0 and will be removed in a future release. Use css.Sass instead.
Built in 1411915 ms
Error: error building site: logged 18 error(s)
make: *** [serve] Error 1

The first two errors cannot be fixed by removing the dates, so we can fix those two. This can be taken up in the same issue. I will update the title to reflect this.

sftim commented 18 minutes ago

/retitle Glossary entries with invalid front matter dates

(The issue describes the problem, not the fix)

sftim commented 18 minutes ago

/triage accepted

sftim commented 17 minutes ago

I'll file an issue about the blog paths.