June maintenance tasks
For June, please add tasks to this issue description and let the assignees know.
Reminder: Typically, all maintenance MRs should have the current milestone, and be labelled with HandbookOperations typemaintenance and other labels as appropriate.
Content tasks
DRI: @cynthia
-
Remove stale codeowners -
Public handbook | !6885 (merged) -
Internal handbook | https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/5009 - Note: can remove once https://gitlab.com/gitlab-com/people-group/peopleops-eng/employment-automation/-/merge_requests/726 is merged.
-
-
Fix trailing spaces - run
markdownlint-cli2 --config tasks/task.markdownlint-cli2.jsonc **/*.md --fix
- where the file should be a copy of what's in https://gitlab.com/gitlab-com/content-sites/handbook-tools/maintenance-tasks/-/tree/main/task_files
- run
-
Check for expired redirects: https://gitlab.com/gitlab-com/content-sites/docsy-gitlab/-/blob/main/layouts/index.redirects, https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/blob/main/layouts/index.redirects, and https://gitlab.com/gitlab-com/content-sites/handbook/-/blob/main/layouts/index.redirects | https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/4931 and !6562 (merged) -
Check for broken external links - run
lychee -c ~tasks/lychee.toml --include-fragments **/*.md
- where the file should be a copy of what's in https://gitlab.com/gitlab-com/content-sites/handbook-tools/maintenance-tasks/-/tree/main/task_files
- Note:
max_redirects
should be decreased if possible, ideally to 0 -
Public handbook | !6994 (merged) -
Internal handbook | https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/4922 and https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/4996 -
Docsy | docsy-gitlab!125 (merged)
- run
-
Check for product docs linter rules changes -
Run linters to double check errors are not being introduced - markdownlint:
markdownlint-cli2 "content/**/*.md" "assets/**/*.md" "layouts/**/*.md"
-
Public handbook (no errors) -
Internal handbook (no errors)
-
- vale:
vale --no-wrap --minAlertLevel error --glob='{content,assets,layouts}/**/*.md' .
-
Public handbook (no errors) -
Internal handbook (no errors)
-
- markdownlint:
-
Check for unlinked images by running unlinked-images.sh
.-
Public handbook | !6888 (merged) !6891 (merged) !6892 (merged) !6893 (merged) !6894 (merged) -
Internal handbook | https://gitlab.com/gitlab-com/content-sites/internal-handbook/-/merge_requests/5010
-
-
Under consideration: Check and compress images using https://pngquant.org/ with something like find . -name '*.png' -print0 | xargs -0 -P8 -L1 pngquant --ext .png --force 256
-
Public handbook -
Internal handbook
-
Backend tasks
DRI: @darbyfrey
-
Review/bump dependencies version: -
golang -
hugo -
nodejs -
docsy @jaime in docsy-gitlab!82 (merged) -
markdownlint @cynthia | No new version -
vale @cynthia | Not required, though repetition exceptions might be nice. - https://gitlab.com/gitlab-com/content-sites/docsy-gitlab/-/blob/main/.tool-versions
- https://gitlab.com/gitlab-com/content-sites/docsy-gitlab/-/blob/main/go.mod
- https://gitlab.com/gitlab-com/content-sites/docsy-gitlab/-/blob/main/.gitlab-ci.yml#L62
-
-
Go tidy job: !6413 (diffs) | Note: The tidy job is still run in the docsy pipeline, so most likely you only need to do it for handbook and internal-handbook if it pops up as an issue in the docsy-theme pipeline. -
Upgrade dependencies in Docsy Gitlab -
Upgrade dependencies in Handbook -
Upgrade dependencies in Internal Handbook
Edited by Cynthia "Arty" Ng