# Comparison Pages Documentation Enhancement Plan

**Last Updated:** 2026-01-09

## Overview

This plan outlines the enhancement of 62 comparison pages documentation files, following the same pattern used for product pages enhancement.

## Current Status

- **Total Pages:** 62 comparison pages
- **Documentation Files:** 62 files exist (templates with basic structure)
- **Enhancement Status:** 0/62 enhanced (0%)
- **Estimated Effort:** 15-20 hours

## Enhancement Pattern

Following the successful product pages enhancement pattern, each comparison page documentation will include:

1. **Enhanced Hero Section** - Extract actual headline, description, CTAs from PHP
2. **Content Strategy** - Messaging, SEO focus, conversion strategy
3. **Schema Markup** - Document all schema types (WebPage, Article, Table, FAQPage, etc.)
4. **Technical Implementation** - Files, dependencies, API endpoints
5. **Maintenance** - Update triggers, content updates, review schedule

## Enhancement Checklist

For each comparison page:

- [ ] Extract hero section details from PHP file
- [ ] Document comparison table structure
- [ ] Extract FAQ questions and answers
- [ ] Document content sections
- [ ] Add content strategy (messaging, SEO keywords)
- [ ] Document schema markup (all types)
- [ ] Add technical implementation details
- [ ] Add maintenance section
- [ ] Update "Last Updated" date
- [ ] Validate documentation

## Priority Order

### Phase 1: High-Traffic Competitors (P0)

1. Planday
2. Personio
3. Deputy
4. Shiftbase
5. Shyftplan
6. Staffomatic
7. Planerio
8. Planovo
9. When I Work
10. Quinyx

**Estimated:** 3-4 hours (10 pages)

### Phase 2: Medium-Traffic Competitors (P1)

11-30: Remaining direct competitors

**Estimated:** 6-8 hours (20 pages)

### Phase 3: Lower-Traffic Competitors (P2)

31-62: Remaining competitors

**Estimated:** 6-8 hours (32 pages)

## Extraction Script

Use existing script or create new one:

```bash
# Extract content from comparison PHP files
python3 scripts/documentation/enhance-comparison-pages.py
```

## Enhancement Template

See `docs/content/pages/product-pages/shiftplan-documentation.md` for reference structure.

## Success Criteria

- All 62 pages enhanced with complete documentation
- Content strategy documented for each page
- SEO keywords extracted and documented
- Schema markup fully documented
- Technical implementation details added
- Maintenance sections complete
- All "To be documented" placeholders removed

## Related Documentation

- [Comparison Pages Guide](../../../guides/comparison-pages/COMPARISON_PAGES_GUIDE.md)
- [Product Pages Enhancement Complete](../product-pages/ENHANCEMENT_COMPLETE.md)
- [Remaining Documentation Gaps](../../../archive/2026-04-01-docs-cleanup/stale-docs-root/REMAINING_DOCUMENTATION_GAPS.md)