# Tier 1 Posts Enhancement Execution Guide

**Last Updated:** 2026-01-15

Step-by-step guide for executing the Tier 1 posts internal linking enhancement process.

## Quick Start

### Phase 1: Dry-Run Testing (Recommended First)

```bash
# Test all enhancement scripts with dry-run
php v2/scripts/blog/batch-enhance-tier1.php --dry-run
```

### Phase 2: Single Post Testing

```bash
# Test on one post first
php v2/scripts/blog/add-pillar-links-tier1.php --dry-run --post=dienstplan-gesetz --category=ratgeber
php v2/scripts/blog/integrate-related-posts-links-tier1.php --dry-run --post=dienstplan-gesetz --category=ratgeber
php v2/scripts/blog/convert-demo-ctas-tier1.php --dry-run --post=dienstplan-gesetz --category=ratgeber
```

### Phase 3: Apply Enhancements

```bash
# Apply to single post (without dry-run)
php v2/scripts/blog/add-pillar-links-tier1.php --post=dienstplan-gesetz --category=ratgeber
php v2/scripts/blog/integrate-related-posts-links-tier1.php --post=dienstplan-gesetz --category=ratgeber
php v2/scripts/blog/convert-demo-ctas-tier1.php --post=dienstplan-gesetz --category=ratgeber
```

### Phase 4: Validate

```bash
# Validate changes
php v2/scripts/blog/validate-tier1-links.php
php v2/scripts/blog/seo-validation-tier1.php
```

## Complete Workflow

### For Each Tier 1 Post

1. **Review Current State**

   - Open post JSON file: `v2/data/blog/posts/{category}/{slug}.json`
   - Review existing links in `content.html`
   - Review `related_posts` array
   - Review FAQ structure (if present)

2. **Run Enhancement Scripts (Dry-Run)**

   ```bash
   php v2/scripts/blog/add-pillar-links-tier1.php --dry-run --post={slug} --category={category}
   php v2/scripts/blog/integrate-related-posts-links-tier1.php --dry-run --post={slug} --category={category}
   php v2/scripts/blog/convert-demo-ctas-tier1.php --dry-run --post={slug} --category={category}
   ```

3. **Review Script Output**

   - Check what changes would be made
   - Verify link placements
   - Verify anchor text
   - Note any issues

4. **Manual Refinement** (if needed)

   - Open post JSON file
   - Review `content.html` field
   - Manually adjust link placement
   - Improve anchor text
   - Ensure natural flow

5. **Apply Changes**

   ```bash
   # Run without --dry-run to apply
   php v2/scripts/blog/add-pillar-links-tier1.php --post={slug} --category={category}
   php v2/scripts/blog/integrate-related-posts-links-tier1.php --post={slug} --category={category}
   php v2/scripts/blog/convert-demo-ctas-tier1.php --post={slug} --category={category}
   ```

6. **Validate**

   ```bash
   php v2/scripts/blog/validate-tier1-links.php
   php v2/scripts/blog/seo-validation-tier1.php
   ```

7. **Browser Test**

   - Load post in browser
   - Test all links
   - Test demo modals
   - Test related carousel
   - Verify FAQs render

8. **Update Checklist**
   - Mark items in `TIER1_ENHANCEMENT_CHECKLIST.md`
   - Document changes made
   - Note any issues

## Batch Processing

### Process All Posts at Once

```bash
# Dry-run first
php v2/scripts/blog/batch-enhance-tier1.php --dry-run

# Apply changes
php v2/scripts/blog/batch-enhance-tier1.php
```

### Process Specific Posts

```bash
# Process single post
php v2/scripts/blog/batch-enhance-tier1.php --post={slug} --category={category}

# Process first 5 posts (for testing)
php v2/scripts/blog/add-pillar-links-tier1.php --limit=5
```

## Script Reference

### Analysis Scripts

- `analyze-tier1-linking-baseline.php` - Baseline analysis
- `map-tier1-pillars.php` - Pillar mapping
- `analyze-tier1-related-posts.php` - Related posts analysis
- `analyze-tier1-faq-structure.php` - FAQ structure analysis
- `analyze-tier1-demo-ctas.php` - Demo CTA analysis

### Enhancement Scripts

- `add-pillar-links-tier1.php` - Add pillar page links
- `integrate-related-posts-links-tier1.php` - Integrate related posts
- `convert-demo-ctas-tier1.php` - Convert demo CTAs
- `enhance-tier1-internal-links.py` - Suggest linking opportunities

### Validation Scripts

- `validate-tier1-links.php` - Validate all links
- `seo-validation-tier1.php` - SEO audit
- `monitor-tier1-links.php` - Monitor link health

### Batch Processing

- `batch-enhance-tier1.php` - Process all posts

## Expected Results

### After Enhancement

- **Link Count:** 10-15 internal links per post
- **Pillar Links:** 14/20 posts have pillar links (70%+)
- **Related Posts:** 80%+ of related posts linked in content
- **Demo CTAs:** 100% use modal buttons
- **SEO Score:** Average 70+ per post

## Troubleshooting

### Script Errors

**Issue:** Script fails to find posts

**Solution:**

- Verify `FAQ_REBUILD_PRIORITY_LIST.md` exists
- Check post file paths are correct
- Verify JSON files are valid

### Link Placement Issues

**Issue:** Links placed awkwardly

**Solution:**

- Manually refine link placement
- Use contextual placement
- Avoid placing right after headings

### Anchor Text Issues

**Issue:** Generic or repeated anchor text

**Solution:**

- Manually improve anchor text
- Use varied, descriptive text
- Match anchor text to context

## Related Documentation

- [Tier 1 Enhancement Process](TIER1_ENHANCEMENT_PROCESS.md)
- [Tier 1 Quality Checklist](TIER1_QUALITY_CHECKLIST.md)
- [Tier 1 Browser Testing Guide](TIER1_BROWSER_TESTING_GUIDE.md)
- [Internal Linking Guide](guides/INTERNAL_LINKING_GUIDE.md)