# Documentation Gaps Analysis

**Last Updated:** 2026-01-08

**Status:** ✅ **GAPS ANALYSIS COMPLETE** - See [Documentation Gaps Analysis 2026](DOCUMENTATION_GAPS_ANALYSIS_2026.md) for comprehensive analysis.

Analysis of missing documentation for tools, pages, competitors, and product features.

## Summary

This document identifies gaps in documentation coverage across all content types on the Ordio website.

**Note:** Comprehensive gap analysis completed. See [Documentation Gaps Analysis 2026](DOCUMENTATION_GAPS_ANALYSIS_2026.md) for detailed findings, priorities, and effort estimates. Many gaps have been addressed through automated documentation generation.

## Content Inventory

### Tools/Calculators

**Total Tools:** 19 (excluding ShiftOps and index)

**Tools Requiring Documentation:**

1. Minijob-Rechner (`tools_minijob_rechner.php`)
2. Stundenlohnrechner (`tools_stundenlohnrechner.php`)
3. Midijob-Rechner (`tools_midijob_rechner.php`)
4. Arbeitslosengeld-Rechner (`tools_arbeitslosengeld_rechner.php`)
5. Brutto-Netto-Rechner (`tools_bruttonettorechner.php`)
6. TVöD-SuE Gehaltsrechner (`tools_tvoed_sue.php`)
7. PayPal Gebührenrechner (`tools_paypal_gebuhrenrechner.php`)
8. Mehrwertsteuer-Rechner (`tools_mehrwertsteuer_rechner.php`)
9. Zinseszinsrechner (`tools_zinseszinsrechner.php`)
10. Industrieminuten-Rechner (`tools_industrieminuten_rechner.php`)
11. Arbeitstage-Rechner (`tools_arbeitstage_rechner.php`)
12. Urlaubsanspruch-Rechner (`tools_urlaubsanspruchrechner.php`)
13. Zuschlagsrechner (`tools_zuschlagsrechner.php`)
14. Kostenrechner (`tools_kostenrechner.php`)
15. ROI-Rechner Schichtplanung (`tools_roi_rechner_schichtplanung.php`)
16. Arbeitszeitrechner (`tools_arbeitszeitrechner.php`)
17. Prozentrechner (`tools_prozentrechner.php`)
18. ShiftOps (`shiftops.php` / `shiftops-report.php`) ✅ - Comprehensive documentation complete

**Documentation Status:**

- ✅ Some tools have documentation in `docs/guides/tools-pages/`
- ❌ Missing: Individual tool documentation files for all 18 tools
- ❌ Missing: Complete technical documentation for each tool
- ❌ Missing: Content structure documentation (hero, FAQs, meta tags)

### Comparison Pages

**Total Comparison Pages:** 64 competitor comparison pages

**Competitors Requiring Documentation:**

1. 7shifts
2. Aplano
3. askDANTE
4. Awork
5. BambooHR
6. ClickUp
7. Clockify
8. Clockin
9. Clockodo
10. Connecteam
11. Crewmeister
12. Deel
13. Deputy
14. E2N
15. FactorialHR
16. FlairHR
17. FreshBooks
18. Gastromatic
19. GFOS
20. Harvest
21. Homebase
22. HR Works
23. HRlab
24. Hubstaff
25. Jethr
26. Kenjo
27. Lattice
28. Leapsome
29. Lexware Office
30. Memtime
31. Moco
32. Nesto
33. Papershift
34. Paycor
35. Pentacode
36. Personio
37. Personizer
38. Planday
39. Planerio
40. Planovo
41. Quinyx
42. Rexx Systems
43. Rippling
44. Sage HR Payroll
45. SAP SuccessFactors
46. Shiftbase
47. Shyftplan
48. Staffomatic
49. Timely
50. Timetac
51. Timr
52. Toggl Track
53. When I Work
54. Workday
55. Workforce.com
56. ZEP
57. ZMI

**Documentation Status:**

- ✅ Comparison page guide exists (`docs/guides/comparison-pages/`)
- ✅ Some competitor data exists in `v2/data/optimized_comparison_data.php`
- ❌ Missing: Individual competitor profile documentation
- ❌ Missing: Page content documentation for each comparison page
- ❌ Missing: Competitor feature/pricing documentation

### Product Pages

**Total Product Pages:** ~13 (need to verify exact count)

**Product Pages Requiring Documentation:**

1. Schichtplanung (`product_shiftplan.php`)
2. Zeiterfassung (`product_timetracking.php`)
3. Abwesenheiten (`product_absences.php`)
4. Lohnabrechnung (`product_payroll.php` and variants)
5. Dokumentenmanagement (`product_documents.php`)
6. Digitale Personalakte (`product_personnelfile.php`)
7. Checklists (`product_checklists.php`)
8. Events (`product_events.php`)
9. App Store (`product_appstore.php`)
10. Webinar (`product_webinar.php`)

**Documentation Status:**

- ✅ Product page guide exists (`docs/guides/PAGE_TYPE_GUIDES.md`)
- ✅ Cursor rule exists (`.cursor/rules/product-pages.mdc`)
- ❌ Missing: Individual product page documentation
- ❌ Missing: Feature functionality documentation
- ❌ Missing: Page content structure documentation

### Industry Pages

**Total Industry Pages:** 5

**Industry Pages Requiring Documentation:**

1. Gastronomie (`industry_hospitality.php`)
2. Einzelhandel (`industry_retail.php`)
3. Pflege (`industry_healthcare.php`)
4. Handwerk (`industry_crafts-and-industry.php`)
5. Freizeit & Kultur (`industry_leisure-and-culture.php`)

**Documentation Status:**

- ✅ Industry page guide exists (`docs/guides/PAGE_TYPE_GUIDES.md`)
- ✅ Cursor rule exists (`.cursor/rules/industry-pages.mdc`)
- ❌ Missing: Individual industry page documentation
- ❌ Missing: Industry-specific content documentation

### Product Features

**Ordio Features Requiring Documentation:**

1. Schichtplanung (Shift Planning)
2. Zeiterfassung (Time Tracking)
3. Abwesenheiten (Absences)
4. Lohnabrechnung (Payroll)
5. Dokumentenmanagement (Document Management)
6. Digitale Personalakte (Digital Personnel File)
7. Checklists
8. Events
9. Mobile Apps
10. Integrations (DATEV, Personio, etc.)

**Documentation Status:**

- ❌ Missing: Comprehensive feature documentation
- ❌ Missing: Feature functionality guides
- ❌ Missing: Use case documentation
- ❌ Missing: Screenshot/documentation assets

### Competitors

**Total Competitors:** 64 (from comparison pages)

**Documentation Status:**

- ✅ Competitor data exists in `v2/data/optimized_comparison_data.php`
- ❌ Missing: Individual competitor profile pages
- ❌ Missing: Competitor feature documentation
- ❌ Missing: Competitor pricing documentation
- ❌ Missing: Market positioning documentation

### Blog Content

**Blog Migration Preparation:**

- ❌ Missing: Complete blog post inventory
- ❌ Missing: Content cluster mapping
- ❌ Missing: Internal linking structure documentation
- ❌ Missing: Migration strategy documentation

## Priority Gaps

### High Priority (Critical for Operations)

1. **Tool Documentation** (18 tools)

   - Individual tool documentation files
   - Technical implementation details
   - Content structure documentation

2. **Competitor Profiles** (64 competitors)

   - Individual competitor profile pages
   - Feature/pricing documentation
   - Market positioning data

3. **Product Feature Documentation** (10+ features)
   - Feature functionality guides
   - Use case documentation
   - Screenshot/documentation assets

### Medium Priority (Important for Maintenance)

4. **Comparison Page Documentation** (64 pages)

   - Individual page content documentation
   - Data source documentation
   - Update requirements

5. **Product Page Documentation** (13 pages)

   - Individual page content structure
   - Feature documentation
   - Update requirements

6. **Industry Page Documentation** (5 pages)
   - Industry-specific content documentation
   - Update requirements

### Low Priority (Future Planning)

7. **Blog Inventory** (Future migration)
   - Complete blog post inventory
   - Content cluster mapping
   - Migration strategy

## Documentation Creation Plan

### Phase 1: Tools Documentation

- Create `docs/content/tools/` structure
- Create individual tool documentation files (18 files)
- Document technical implementation for each tool
- Document content structure (hero, FAQs, meta tags)

### Phase 2: Competitor Documentation

- Create `docs/content/competitors/` structure
- Create competitor inventory
- Create individual competitor profiles (64 files)
- Document features, pricing, positioning

### Phase 3: Product Feature Documentation

- Create `docs/content/product-features/` structure
- Document all Ordio features
- Create feature functionality guides
- Document use cases and screenshots

### Phase 4: Page Documentation

- Create `docs/content/pages/` structure
- Document comparison pages (64 pages)
- Document product pages (13 pages)
- Document industry pages (5 pages)

### Phase 5: Blog Inventory

- Create `docs/content/blog/` structure
- Inventory all blog posts
- Map content clusters
- Document internal linking structure

## Next Steps

1. Create documentation structure (`docs/content/`)
2. Start with high-priority gaps (tools, competitors, product features)
3. Create templates for each documentation type
4. Populate documentation systematically
5. Establish maintenance processes