Skip to content

seo(VIDEOS): backfill metadata for 37 pages#28

Open
bblietz wants to merge 1 commit intorokudev:v2.0from
bblietz:seo/phase2-videos-batch1
Open

seo(VIDEOS): backfill metadata for 37 pages#28
bblietz wants to merge 1 commit intorokudev:v2.0from
bblietz:seo/phase2-videos-batch1

Conversation

@bblietz
Copy link
Copy Markdown

@bblietz bblietz commented May 8, 2026

Summary

Phase 2.C of the SEO frontmatter backfill effort. 37 of 49 VIDEOS pages receive populated metadata.title (suffixed form), metadata.description, and excerpt fields. No body content modified.

Pipeline

Identical to #26 (REFERENCES) and #27 (DEVELOPER).

Outcomes

VIDEOS pages in snapshot 49
Generator successes 49 (100%)
Validator passes 38 (78%)
Applied in this PR 37
Validator-flagged 11
Non-canonical shape (deferred) 1

Top flag categories (11 deferred)

  • 3 em-dash (model produced em dashes despite stoplist)
  • 3 title-format (suffixed-title length out of band)
  • 2 source-grounding
  • 2 stub pattern
  • 1 length

Note on the 1 non-canonical file

docs/VIDEOS/demos/app-tracing-with-perfetto-webinar.md has a sparse metadata block missing the title key. Current YAML walker requires the canonical empty-fields shape to insert. Will be handled in a follow-up apply-tool enhancement.

Test plan

  • Spot-check files in docs/VIDEOS/courses/ for description-vs-body alignment
  • Spot-check files in docs/VIDEOS/demos/ and docs/VIDEOS/sdk-tools/
  • Verify no body content changed
  • Verify suffixed-title form

🤖 Generated with Claude Code

…or 37 pages

Phase 2.C of the SEO frontmatter backfill effort. 37 of 49 VIDEOS pages
receive populated metadata.title (suffixed form), metadata.description, and
excerpt fields. No body content modified.

Pipeline identical to PR rokudev#26 / rokudev#27 (REFERENCES, DEVELOPER).

Excluded:
  - 11 files validator-flagged (em-dash usage, paraphrase grounding, title
    suffix-band length, stub pattern).
  - 1 file with non-canonical frontmatter shape (missing metadata.title key
    inside a sparse metadata block) -- requires apply-tool enhancement to
    insert missing keys; deferred to a follow-up.
  - 0 generator-failed (49 of 49 generated successfully).

Validator pass rate: 38 of 49 generated (78%); 37 land in this PR after
the 1 non-canonical exclusion.
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