Site Improvement Guides
Site Improvement Guides
Comprehensive improvement documentation for efrenrodriguezrodriguez.com.
Each document contains deep analysis of the current state, concrete implementation code, and a priority matrix.
Documents
| # | Document | Focus Area | Key Wins |
|---|---|---|---|
| 01 | Performance | LCP, CLS, FID optimization | Font loading, image dimensions, script defer, service worker |
| 02 | SEO & Structured Data | Search visibility, rich snippets | JSON-LD schemas, OG images, meta descriptions, config fixes |
| 03 | Accessibility | WCAG 2.1 AA compliance | Skip link, focus indicators, color contrast, ARIA live regions |
| 04 | Content & UX | Engagement, content strategy | Blog pillars, project enhancements, search, 404 page |
| 05 | Code Quality | Dead code removal, cleanup | ~475 lines removable, bundle reduction, config cleanup |
| 06 | Missing Features | New functionality | Search, filtering, sharing, contact form, RSS visibility |
Quick Start: Top 10 Highest-Impact Changes
These are the highest impact improvements across all documents, ordered by effort:
Low Effort, High Impact
- Add
deferto scripts -01-performance.mdSection 3 - Fill
_config.ymlsocial/og_image -02-seo-structured-data.mdSection 1 - Add skip navigation link -
03-accessibility.mdSection 1 - Add image width/height attributes -
01-performance.mdSection 2 - Fix light-mode color contrast -
03-accessibility.mdSection 3
Medium Effort, High Impact
- Add Person JSON-LD schema -
02-seo-structured-data.mdSection 2 - Add ScholarlyArticle schema -
02-seo-structured-data.mdSection 8 - Reduce font weights (5 to 2) -
01-performance.mdSection 1 - Project page enhancements -
04-content-ux.mdSection 2 - Remove dead CSS/JS -
05-code-quality.mdSections 1-2
How to Use These Docs
- Start with P0 items from each document’s priority matrix
- Measure before and after with Lighthouse (
npx lighthouse https://efrenrodriguezrodriguez.com) - Implement one category at a time to isolate the impact of changes
- Test locally with
bundle exec jekyll servebefore pushing - Rebuild JS after any
_main.jschanges:npm run build:js