Skip to content

docs: remove 190 unreferenced images - #16083

Merged
Maffooch merged 1 commit into
bugfixfrom
docs/prune-orphaned-images
Sep 25, 2026
Merged

Maffooch merged 1 commit into
bugfixfrom
docs/prune-orphaned-images

Conversation

@paulOsinski

Copy link
Copy Markdown
Contributor

Removes 190 image files under docs/ that are not referenced from anywhere in the
repository. About 28 MB.

These accumulated the usual way: a docs page is rewritten or deleted and its screenshots
are left behind. The About_Custom_Dashboard_Tiles_* series is a dozen files from one
such page.

How the list was built

Every tracked image basename was searched for across the whole repository, not just
docs/ — every text file outside .git and node_modules, including layouts, data
files, Hugo shortcodes, Django templates and the root README. An image is on this list
only if no exact reference to it was found anywhere.

Matching is on literal basenames with a boundary check, rather than a regex describing
what a filename may contain. Two rounds of verification caught files that a narrower
check would have deleted:

  • Three images whose names contain & (Configure_System_&_Personal_Notifications*.png)
    are referenced from the notification docs in eight languages.
  • Five social icons (updated-dojo-chop.png, slack-logo-icon.png,
    Linkedin-logo-icon-png.png, x_logo.jpg, YouTube-Emblem.png) are referenced from
    the root README.md through github.com/ghraw URLs pointing into
    docs/assets/images/. Deleting those would have broken the images on the project's
    GitHub front page.
  • docs/assets/images/logo.png is kept as well. Nothing in docs/ references it, but
    the login and report-cover templates reference a logo.png under dojo/img/, and a
    delete list is the wrong place to resolve that kind of ambiguity.

The names are unique across the corpus, so basename matching is unambiguous here.

Verification

After deletion, every image referenced from docs/content/**/*.md still resolves — zero
broken references.

Release-note and archived-docs screenshots were never candidates: those are historical
records of what a given version looked like, so they are excluded by design rather than
by accident.

🤖 Generated with Claude Code

These are images under docs/ that nothing in the repository references --
roughly 28 MB, accumulated as docs pages were rewritten or deleted without
pruning their screenshots.

The list was built by searching every tracked image basename across the whole
repository, not just docs/, matching literal basenames with a boundary check
rather than a regex describing what a filename may contain. That kept eight
files that a narrower check would have deleted: three whose names contain "&"
and are referenced from the notification docs, and five social icons the root
README hotlinks out of docs/assets/images/ through github.com/ghraw.

Every image referenced from docs/content still resolves after this change.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@paulOsinski paulOsinski added this to the 3.3.300 milestone Sep 24, 2026
@github-actions github-actions Bot added the docs label Sep 24, 2026
@paulOsinski
paulOsinski marked this pull request as draft September 24, 2026 19:36
@paulOsinski
paulOsinski marked this pull request as ready for review September 24, 2026 19:46
@Maffooch
Maffooch added this pull request to the merge queue Sep 25, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Sep 25, 2026
@Maffooch
Maffooch added this pull request to the merge queue Sep 25, 2026
Merged via the queue into bugfix with commit 6deb891 Sep 25, 2026
31 checks passed
@Maffooch
Maffooch deleted the docs/prune-orphaned-images branch September 25, 2026 21:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants