aRustyDev / aRustyDev/blog

review: SEO optimization strategy (meta tags, Open Graph, structured data)

Open
#55 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Summary

Review and improve the blog's SEO optimization strategy, focusing on HTML meta tags, Open Graph protocol, and structured data.

## Areas to Review

### 1. HTML Meta Tags

**Current State:** Review `src/layouts/Layout.astro`

| Tag | Status | Notes |
|-----|--------|-------|
| `` | Implemented | Dynamic per page |
| `<meta name="description">` | Implemented | From page props |
| `<meta name="author">` | Implemented | From SITE config |
| `<meta name="viewport">` | Implemented | Standard responsive |
| `<link rel="canonical">` | Implemented | Dynamic URL |
| `<meta name="robots">` | Missing? | May need for draft posts |
| `<meta name="keywords">` | Missing | Controversial value, consider tags |

**Tasks:**
- [ ] Audit current meta tag implementation
- [ ] Add `robots` meta tag for draft/unlisted posts
- [ ] Consider `keywords` meta from post tags
- [ ] Verify character limits (title: 60, description: 160)

### 2. Open Graph Protocol

**Current State:** Basic OG tags implemented

| Tag | Status | Notes |
|-----|--------|-------|
| `og:title` | Implemented | |
| `og:description` | Implemented | |
| `og:url` | Implemented | Canonical URL |
| `og:image` | Implemented | Generated OG images |
| `og:type` | Missing? | Should be `article` for posts |
| `og:site_name` | Missing? | Brand consistency |
| `og:locale` | Missing? | For i18n |
| `article:published_time` | Implemented | |
| `article:modified_time` | Implemented | |
| `article:author` | Missing? | |
| `article:tag` | Missing? | From post tags |

**Tasks:**
- [ ] Add missing OG tags (`og:type`, `og:site_name`, `og:locale`)
- [ ] Add article-specific tags (`article:author`, `article:tag`)
- [ ] Verify OG image dimensions (1200x630 recommended)
- [ ] Test with Facebook Sharing Debugger

### 3. Twitter Card Meta Tags

**Current State:** Basic implementation

| Tag | Status | Notes |
|-----|--------|-------|
| `twitter:card` | Implemented | `summary_large_image` |
| `twitter:title` | Implemented | |
| `twitter:description` | Implemented | |
| `twitter:image` | Implemented | |
| `twitter:site` | Missing? | @aRustyDev |
| `twitter:creator` | Missing? | Author's Twitter handle |

**Tasks:**
- [ ] Add `twitter:site` with blog's Twitter handle
- [ ] Add `twitter:creator` for post authors
- [ ] Test with Twitter Card Validator

### 4. Structured Data (JSON-LD)

**Current State:** BlogPosting schema implemented

**Review:**
- [ ] Audit current JSON-LD schema
- [ ] Add `WebSite` schema for homepage
- [ ] Add `BreadcrumbList` schema for navigation
- [ ] Add `Person` schema for author page
- [ ] Consider `TechArticle` schema for technical posts
- [ ] Test with Google Rich Results Test

**Schema Types to Consider:**

```json
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "aRustyDev Blog",
"url": "https://blog.arusty.dev",
"potentialAction": {
"@type": "SearchAction",
"target": "https://blog.arusty.dev/search?q={search_term_string}",
"query-input": "required name=search_term_string"
}
}
```

### 5. Technical SEO

**Tasks:**
- [ ] Verify sitemap generation (`/sitemap-index.xml`)
- [ ] Verify robots.txt configuration
- [ ] Add RSS feed auto-discovery (already implemented?)
- [ ] Check page load performance (Lighthouse)
- [ ] Verify mobile-friendliness
- [ ] Check for broken links
- [ ] Verify HTTPS and redirects

### 6. Content SEO

**Tasks:**
- [ ] Ensure all images have alt text
- [ ] Add heading hierarchy validation
- [ ] Consider adding table of contents for long posts
- [ ] Review URL slug conventions
- [ ] Add related posts functionality

## Testing Tools

- [Google Rich Results Test](https://search.google.com/test/rich-results)
- [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/)
- [Twitter Card Validator](https://cards-dev.twitter.com/validator)
- [Schema.org Validator](https://validator.schema.org/)
- [Google PageSpeed Insights](https://pagespeed.web.dev/)

## Acceptance Criteria

- [ ] All meta tags pass validation
- [ ] OG images display correctly on social platforms
- [ ] Structured data passes Google Rich Results Test
- [ ] Lighthouse SEO score >= 95
- [ ] Documentation of SEO best practices for future posts

## Labels
enhancement, seo, review

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.