Skip to content

Validate profile links assets and catalog drift in CI #5

Description

@Scriptception

Problem

Current CI checks whitespace and basic file signatures but does not detect broken profile links, inaccessible image references, stale generated catalog content, or malformed Markdown structure.

User outcome

Profile changes fail with actionable evidence before GitHub visitors encounter broken or inconsistent organization information.

Scope

  • Validate generated catalog freshness and manifest conformance.
  • Check internal and approved external links with bounded retry behavior.
  • Validate Markdown structure, image alternative text, raw asset URLs, SVG parsing, and PNG signatures.
  • Keep checks read-only and deterministic where possible.

Non-goals

  • Making CI permanently dependent on every external destination.
  • Replacing manual visual review of GitHub rendering.

Acceptance criteria

  • CI detects stale catalog output, broken internal links, malformed assets, and missing required alternative text.
  • External-link policy documents retry, timeout, and allowlist behavior.
  • Failures identify the exact source location and remediation.
  • The workflow retains read-only permissions and pinned actions.

Validation

  • Seed one failure for each validation class and confirm detection.
  • Render the profile on desktop and mobile after automated checks pass.

Relationships

  • Depends on generated profile catalog.
  • Complements website link and accessibility validation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions