Skip to content

SEO.md compliance: meta descriptions and hero heading semantics - #120

Merged
NeedToUpdate merged 2 commits into
devfrom
fix/seo-md-compliance
Jul 22, 2026
Merged

SEO.md compliance: meta descriptions and hero heading semantics#120
NeedToUpdate merged 2 commits into
devfrom
fix/seo-md-compliance

Conversation

@NeedToUpdate

Copy link
Copy Markdown
Owner

Audit of every page and article against SEO.md, prompted by Bing Webmaster flags.

Changes

  • Meta descriptions into the 120–160 band. Home (75→153), /insights (85→147), and /contact (46→147) each get a description naming what the page delivers. The home description is page-level metadata; the on-page hero and brand line are untouched.
  • seoDescription frontmatter for case studies. Mirrors the existing seoTitle pattern for insights: feeds the meta description and Article JSON-LD, falls back to impact. Applied to sdlc-revamp (90→148), student-pipeline (94→151), and tableau (88→155), whose on-page impact lines stay as written. All new copy uses only facts already in each file.
  • ARIA level on the demoted hero. The desktop hero twin (rendered as p since Fix duplicate h1 on homepage (SEO) #118's duplicate-h1 fix) now carries role="heading" aria-level="1", so the breakpoint where the real h1 is display:none still exposes a level-1 heading to assistive tech.

What already passed the audit

Titles (44–62 chars, decision-first with brand suffix), self-referencing canonicals, one H1 per page, og/twitter tags, visible bylines linking to /about, max-image-preview:large, robots.txt, the /md mirror's rel=canonical header, JSON-LD (Person, WebSite, ProfilePage, Article, BreadcrumbList), 1200×630 OG image, square 48px+ favicon.

Flagged, not changed

  • Case-study schema marks the delivery date as datePublished/dateModified and no date is visible on-page (documented as deliberate in lib/types.ts).
  • GroundNet and Ziggy link no case study; no relevant one exists yet, and SEO.md's rule applies only "when those pages exist".
  • Article schema carries one image; the guide asks for 16:9/4:3/1:1 crops ≥50k px (build-script work).
  • /work sitemap entries have no lastModified; the only available date is project delivery, which would be untruthful as a modification date.

NeedToUpdate and others added 2 commits July 20, 2026 23:14
- lift home, insights, and contact meta descriptions into the 120-160
  character band, naming what each page delivers
- add a seoDescription frontmatter override for case studies (meta +
  JSON-LD, falling back to impact) and use it on sdlc-revamp,
  student-pipeline, and tableau, whose impact lines run short
- expose the demoted desktop hero's heading level via ARIA so the
  visible page keeps a level-1 heading at every breakpoint
@NeedToUpdate
NeedToUpdate merged commit 092fcfc into dev Jul 22, 2026
1 check passed
@NeedToUpdate
NeedToUpdate deleted the fix/seo-md-compliance branch August 2, 2026 02:38
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