Skip to content

Sticky nav, profile image slot, social links, and AEO/schema updates#36

Merged
ryanbaumann merged 1 commit into
mainfrom
codex/review-repo-for-clarity-and-optimization
Jul 12, 2026
Merged

Sticky nav, profile image slot, social links, and AEO/schema updates#36
ryanbaumann merged 1 commit into
mainfrom
codex/review-repo-for-clarity-and-optimization

Conversation

@ryanbaumann

Copy link
Copy Markdown
Owner

Motivation

  • Improve discoverability and answer-engine clarity by aligning visible homepage claims with JSON-LD and adding concrete proof points.
  • Surface primary social/content sources (LinkedIn, X, Substack) across the site and schema so links and sharing are explicit.
  • Improve accessibility and layout resilience by making the header sticky, adding a skip link, and making the top nav horizontally scrollable on small screens.
  • Prevent layout shift and provide a stable visual slot for a local profile image to replace blocked remote fetches.

Description

  • Added a skip link and conditional footer links for x and substack and updated the header layout in portfolio/build.mjs and the generated layout HTML.
  • Enhanced structured data by expanding jsonLdPerson() with description, knowsAbout, and sameAs sources and adding a jsonLdHomePage() that emits a ProfilePage tied to the person schema.
  • Added homepage proof points and a local profileImage slot (with profileImageAlt) that reads dimensions via getImageDimensions() and renders width/height attributes to avoid CLS, plus a checked-in SVG placeholder at portfolio/static/img/ryan-baumann-profile.svg.
  • Updated portfolio/style.css to make the header position: sticky, enable horizontal nav scrolling, add .profile-image and .proof-grid styles, and ensure responsive images with height: auto.
  • Content and metadata updates in portfolio/content/site.json and portfolio/content/pages/about.md to tighten copy, add Caterpillar and proof points, and set an answerEngineSummary.
  • Documentation updates: added CHANGELOG.md entries, LEARNINGS.md additions, and a TODO.md checklist describing the copy/trust pass.

Testing

  • Ran the static site build with the portfolio build script (npm run build / node portfolio/build.mjs) and the generator completed and wrote updated pages without errors.
  • Ran the repository test script (npm test) to exercise CI-safe test behavior and the test suite completed successfully.
  • Verified generated pages include the new ProfilePage and Person JSON-LD, the homepage proof points, and the profile image width/height attributes during the build step.

Codex Task

@ryanbaumann ryanbaumann merged commit 84da4e4 into main Jul 12, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant