Skip to content

docs(showcase): repair broken v2 asset paths in index.html#101

Merged
DemchaAV merged 1 commit into
developfrom
docs/fix-showcase-broken-paths
May 31, 2026
Merged

docs(showcase): repair broken v2 asset paths in index.html#101
DemchaAV merged 1 commit into
developfrom
docs/fix-showcase-broken-paths

Conversation

@DemchaAV

Copy link
Copy Markdown
Owner

Summary

External presentation audit ahead of the v1.6.6 Maven Central debut surfaced 20 of 27 showcase references in docs/index.html rendering as 404. After the CV v2 layered migration in 1.6.x, every preset's screenshot and PDF was renamed with a -v2 suffix on disk, but the GitHub Pages site (demchaav.github.io/GraphCompose/) still referenced the pre-migration paths.

Fix

Pattern Action Count
cv/cv-X.{pdf,png} cv/cv-X-v2.{pdf,png} 14 CV PDFs + 1 PNG
coverletter/cover-letter-X.{pdf,png} coverletter/cover-letter-X-v2.{pdf,png} 4 specific cover letters
coverletter/cover-letter.pdf coverletter/cover-letter-modern-professional-v2.pdf 1 generic landing link
Invoice / proposal / schedule unchanged already correct

Verification

$ for ref in $(grep -oE 'showcase/[a-z]+/templates/[a-z/]+[a-z-]+(-v2)?\.[a-z]+' docs/index.html | sort -u); do
    [ -f "docs/$ref" ] || echo "BROKEN: $ref"
  done
(empty — all 26 unique references resolve on disk)

Why this is a release-blocker

The next Maven Central debut tag (v1.6.6) will route significantly more traffic at the Pages site. Broken-image-laden first impression for every new caller would have cost trust. Fixing this before cut is cheap; fixing after means days of broken homepage in the Central debut window.

This is Phase A of the pre-release polish plan; Phases B + C (hero PDF + README banner replacement) follow.

Test plan

  • All 26 unique referenced paths resolve via ls
  • Diff is mechanical / structurally identical (sed substitution only)
  • CI green on PR
  • Visual verification on Pages once merged (homepage hero + CV gallery)

After the CV v2 layered migration (1.6.x), every preset's screenshot and PDF was renamed with a '-v2' suffix on disk (cv-blue-banner-v2.png, cover-letter-executive-v2.pdf, etc.). The docs/index.html GitHub Pages site still referenced the pre-migration paths (without -v2), so 20 of 27 showcase references rendered as 404 — almost the entire CV gallery and the cover-letter previews.

Surfaced by an external visual-presentation audit ahead of the v1.6.6 Maven Central debut: a broken-image-laden showcase site would have been the first impression for every new Central caller.

Fix is mechanical:

  cv/cv-X.{pdf,png} -> cv/cv-X-v2.{pdf,png}        (14 CV PDFs + 1 PNG)

  coverletter/cover-letter-X.{pdf,png} -> coverletter/cover-letter-X-v2.{pdf,png}  (4 specific letters)

  coverletter/cover-letter.pdf -> coverletter/cover-letter-modern-professional-v2.pdf  (the generic 'cover letter' link now points at the recommended preset)

Invoice + proposal + schedule paths were already correct (no v2 migration there).

Verification: all 26 remaining unique references resolve on disk (one collapsed by sorted-unique dedup; same file). No regression to other docs surfaces.
@DemchaAV DemchaAV merged commit 7cfa21b into develop May 31, 2026
11 checks passed
@DemchaAV DemchaAV deleted the docs/fix-showcase-broken-paths branch May 31, 2026 19:16
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