Skip to content

docs(help): purge 131 orphaned image assets - #171

Merged
ddehilster merged 2 commits into
VisualText:mainfrom
ddehilster:docs/purge-orphan-images
Jun 25, 2026
Merged

ddehilster merged 2 commits into
VisualText:mainfrom
ddehilster:docs/purge-orphan-images

Conversation

@ddehilster

Copy link
Copy Markdown
Member

Summary

Purges 131 orphaned image assets under Help/helps/ — image files referenced by no help page. They are almost entirely desktop-VisualText UI screenshots (Popups, Menus, Toolbars, Tools, Windows, Toolbar_buttons, Dialog_boxes) that became dead weight when the desktop-UI pages (and the Possibly_JUNK walkthrough) were removed.

Each file was identified with check-help-docs.ps1 -Images and verified referenced by no markdown page.

Validation

After deletion: 0 broken image links, 0 orphaned image assets remaining. 349 referenced images kept. (0 broken .md links, 0 table/index drift.)

⚠️ Stacked on #170

This branch builds on #170 (it includes #170's commit). The full 131-image set is only correct once #170 is applied — the removed Basic_steps page referenced 3 of these images. Merge #170 first; this PR's diff then narrows to just the 131 image deletions. (Merging this alone would bring #170's changes in too.)

🤖 Generated with Claude Code

ddehilster and others added 2 commits June 25, 2026 18:31
…junk folder

Maintenance batch (stacked on the desktop-UI prune):

#1 CI: add .github/workflows/check-help-docs.yml running check-help-docs.ps1
   on PRs/pushes touching Help/ (windows-latest); fails on broken .md links,
   broken image links, or table/index drift.

VisualText#5 Guard script: add broken-image-link checking to the gating path and a
   -Images mode that lists orphaned image assets (referenced by no page).

#2 Remove the stale CHM/HTML build tree under Help/helps/ (561 .htm plus
   .html/.css/.hhc/.hhk/.js/.xml/.glo/.brs). KEPT all 480 image assets, which
   the markdown references via ../helps/.

#3 De-duplicate debug/fail: the flat pages and the Functions/ copies had
   diverged. Merged the PRE-action accuracy into flat debug.md, added the
   CHECK Actions link to fail.md, repointed all references (index, exitpass,
   or, succeed) to the flat copies, and removed the Functions/ folder.

#4 Remove the Possibly_JUNK/ folder: NLP++.md was explicitly marked "slated
   for removal" and is superseded by the NLP++ section; Basic_steps... is a
   legacy desktop-GUI walkthrough. Removed both and their index entries.

Verified: check-help-docs.ps1 reports 0 broken links, 0 broken images,
0 table/index drift. Note: -Images surfaces 131 orphaned image assets (mostly
desktop-UI screenshots orphaned by the page prune) -- left for a follow-up.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Remove image files under Help/helps/ that are referenced by no help page --
almost entirely desktop-VisualText UI screenshots (Popups, Menus, Toolbars,
Tools, Windows, Toolbar_buttons, Dialog_boxes) orphaned when the desktop-UI
pages and the Possibly_JUNK walkthrough were removed.

Identified with `check-help-docs.ps1 -Images` (each verified referenced by no
markdown page). Verified after deletion: 0 broken image links, 0 orphaned
image assets remaining; 349 referenced images kept.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@ddehilster
ddehilster merged commit b5bb603 into VisualText:main Jun 25, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant