2024-07 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/

Content tasks

1. Remove stale codeowners
   • Handbook gitlab-com/content-sites/handbook!7642 (merged)
   • Internal handbook https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/5183
   • Note: can remove once https://gitlab.com/gitlab-com/people-group/peopleops-eng/employment-automation/-/merge_requests/726 is merged.
2. Fix trailing spaces
   • Handbook
   • Internal handbook
3. Check for expired redirects
   • Handbook
   • Internal handbook
4. Check for broken external links
   • Handbook | gitlab-com/content-sites/handbook!7146 (merged) and see related issues for ones I couldn't fix
   • Internal handbook
   • Docsy-theme
5. Check for product docs linter rules changes
   • markdownlint: https://gitlab.com/gitlab-org/gitlab/-/blob/master/.markdownlint-cli2.yaml | subheading length is noted and will do it next month
   • vale: https://gitlab.com/gitlab-org/gitlab/-/tree/master/doc/.vale | https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/5187 and gitlab-com/content-sites/docsy-gitlab!148 (merged)
6. Run linters to double check errors are not being introduced
   • markdownlint
     • Handbook
     • Internal handbook
   • vale
     • Handbook
     • Internal handbook
7. Check for unlinked images
   • Handbook gitlab-com/content-sites/handbook!7646 (merged)
   • Internal handbook https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/5186
8. Check and compress images using https://pngquant.org/ with something like find . -name '*.png' -print0 | xargs -0 -P8 -L1 pngquant --ext .png --force 256. Use find . -name '*.jpg' -print0 | xargs -0 -P8 -L1 jpegoptim -t -T2 and for jpeg for JPG images. https://www.kokkonen.net/tjko/src/man/jpegoptim.txt Alternatively use git repack?
   • Handbook | gitlab-com/content-sites/handbook!7236 (merged)
   • Internal handbook | https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/5098
   • Document image compression task | gitlab-com/content-sites/docsy-gitlab!137 (merged)

Backend tasks

1. Go tidy
2. Review/bump dependencies version:
   • golang
   • hugo
   • nodejs
     • To review, NPM says there are 2 vulnerabilities in the packages we use.
   • docsy
   • markdownlint
   • vale
3. Upgrade dependencies
   • Docsy-theme
   • Handbook
   • Internal handbook
4. One-off task (from #3 (comment 1988687299)): Resolve deprecation notices related to:
   • .Site.DisqusShortname
   • lang.NumFmt

Other tasks

1. One-off: Before closing this issue, check that the next month's task issue has been created.