[2024-10] Monthly Handbook Maintenance Tasks

Reminder: Typically, all maintenance MRs should have the current milestone, and be labelled with HandbookOperations typemaintenance and other labels as appropriate.

Documentation: https://handbook.gitlab.com/docs/development/maintenance/

General tasks

1. Set the Due date to the last working day of this month
2. Set the milestone to the one corresponding to the due date

Content tasks

1. Compress images | added CI job
   • Handbook
   • Internal handbook
2. Check for unlinked images
   • Handbook
   • Internal handbook
3. Check for broken external links
   • Handbook (214)
   • Internal handbook (162)
   • Docsy-theme (0)
4. Check for broken internal links
   • Handbook | gitlab-com/content-sites/handbook!9575 (merged)
   • Internal handbook | https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/5665
5. Check for product docs linter rules changes
   • markdownlint: https://gitlab.com/gitlab-org/gitlab/-/blob/master/.markdownlint-cli2.yaml
   • vale: https://gitlab.com/gitlab-org/gitlab/-/tree/master/doc/.vale
6. Run linters to double check errors are not being introduced
   • markdownlint
     • Handbook (9) gitlab-com/content-sites/handbook!9322 (merged)
     • Internal handbook
   • vale
     • Handbook
     • Internal handbook
7. Fix trailing spaces | added CI job
   • Handbook
   • Internal handbook
8. Check for expired redirects
   • Handbook
   • Internal handbook
9. Clean up stale/branches for closed MRs
   • Handbook
   • Internal handbook

Backend tasks

1. Go tidy
2. Review/bump dependencies version:
   • docsy
   • golang
   • hugo
   • nodejs
   • markdownlint
   • vale
3. Upgrade dependencies
   • Docsy-theme
   • Handbook
   • Internal handbook
4. One-time tasks
   • Should be resolved in 2024-10 as it's an ERROR in hugo v0.135.0+extended From build job hugo v0.131.0+extended linux/amd64 BuildDate=unknown
   • WARN deprecated: .Site.Social was deprecated in Hugo v0.124.0 and will be removed in a future release. Use .Site.Params instead.
   • WARN deprecated: data.GetCSV was deprecated in Hugo v0.123.0 and will be removed in a future release. use resources.Get or resources.GetRemote with transform.Unmarshal.
   • WARN deprecated: data.GetJSON was deprecated in Hugo v0.123.0 and will be removed in a future release. use resources.Get or resources.GetRemote with transform.Unmarshal.