seo: comprehensive SEO/GEO audit — HowTo schemas, Speakable, DefinedTermSet, freshness#42
Open
elninad wants to merge 1 commit into
Open
seo: comprehensive SEO/GEO audit — HowTo schemas, Speakable, DefinedTermSet, freshness#42elninad wants to merge 1 commit into
elninad wants to merge 1 commit into
Conversation
…ermSet, freshness (#42) Audit findings and improvements: SEO/GEO Structural improvements: - Add 3 HowTo JSON-LD schemas (highest GEO citation value for instructional content): • How to Set Up a Private npm Registry Using Nexus Repository Manager • How to Configure AWS CloudFront CDN with AWS WAF for High-Traffic Apps • How to Transition from Senior Engineer to Principal Engineer - Add DefinedTermSet schema defining Ninad's 5 core expertise domains (Staff+ Engineering, Platform Engineering, Cloud-Native Architecture, Leadership Without Authority, Fintech Platform Engineering) - Add Speakable specification to all 4 article schemas (voice search + LLM oral citation) - Add audience property to all 4 article schemas (GEO targeting signal) - Add mainEntityOfPage to all article schemas (entity graph reinforcement) - Add author name to all article keywords arrays (entity association) - Add sameAs Wikipedia links to article about[] entries WebSite schema improvements: - Add maintainer, copyrightNotice, accessibilityFeature, accessMode, accessModeSufficient, and audience properties FAQ improvements (3 new Q&As in both HTML and JSON-LD): - How to set up a private npm registry (technical instructional content) - How to configure AWS CloudFront CDN with WAF (from Upstox production work) - Ninad Malvankar's email address (contact/entity signal) Freshness signals updated across all 7 files: - index.html: DCTERMS.modified, citation_publication_date, og:updated_time, last-modified, dateModified, lastReviewed, footer date - sitemap.xml: all 5 <lastmod> entries - llms.txt, llms-full.txt, ai.txt, humans.txt, feed.xml: Last updated dates Result: JSON-LD @graph expanded from 17 to 21 nodes; all 15 audit checks pass; zero stale 2026-05-22 date signals remain in the page. https://claude.ai/code/session_01DYu6angVjmCmMskzKiuTe8
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Full SEO + GEO audit of ninadmalvankar.com. The site already had strong foundations (Person schema, 42-item FAQPage, llms.txt, robots.txt with 40+ AI crawler rules). This PR adds the genuinely missing pieces identified in the audit.
What was missing / what this fixes
HowToschema — highest GEO value schema type for instructional contentHowToschemas (npm registry setup, CloudFront+WAF config, Principal Engineer career path)Speakablespecification on articles — skips voice search and LLM oral citationsSpeakableSpecificationto all 4 article schemasaudienceproperty on articles — reduces GEO targeting precisionaudienceto all 4 article schemasDefinedTermSet— LLMs lack structured vocab for Ninad's expertise domainDefinedTermSetwith 5 defined terms (Staff+ Engineering, Platform Engineering, Cloud-Native Architecture, Leadership Without Authority, Fintech Platform Engineering)WebSiteschema missingmaintainer,copyrightNotice,accessibilityFeatureaccessModeandaccessModeSufficientmainEntityOfPage→ entity graph not fully connectedmainEntityOfPagepointing to#webpageon all articlesindex.html,sitemap.xml,llms.txt,llms-full.txt,ai.txt,humans.txt,feed.xmlKnown issue (out of scope)
The
og:imageis an SVG file. Facebook and LinkedIn do not render SVG OG images — shares show no preview image. Fixing requires generating a 1200×630 PNG. Flagging for a follow-up.Audit results
@graphexpanded: 17 → 21 nodes2026-05-22date signals remaining inindex.htmlTest plan
masterto trigger GitHub Pages deploymenthttps://claude.ai/code/session_01DYu6angVjmCmMskzKiuTe8
Generated by Claude Code