# Jahresgespräch – Creation Notes

**Last Updated:** 2026-02-23

## Decisions

### Product Mapping
- Product mapping → `/digitale-personalakte`, `/dokumentenmanagement` (same as zielvereinbarung per blog-product-feature-mapping.json).

### Related Posts & Carousels
- Put **zielvereinbarung** first in related_posts (closest concept; Zielvereinbarung is part of Jahresgespräch).
- `add-new-post-to-related-carousels.php` run with targets: zielvereinbarung, personalentwicklung-und-weiterbildung, fuehrungskraefteentwicklung, employee-engagement, bonuszahlung, gratifikation, personalcontrolling, change-management, mitarbeiterbindung, nachfolgeplanung.
- Jahresgespraech added to 10 related post carousels.

### Content Differentiation
- **Jahresgespräch vs. Zielvereinbarung:** H2 added with link to /insights/lexikon/zielvereinbarung/. Zielvereinbarung is a component of Jahresgespräch, not a separate format.
- **Mitarbeitergespräch:** Mentioned without link (no Ordio post; gap in LEXIKON_CONTENT_GAPS).

### Bidirectional Links (Backlinks)
- **zielvereinbarung:** Added jahresgespraech link at "Teil eines strukturierten Gesprächs" → "Teil eines strukturierten Jahresgesprächs" (with link) via update-post-content.php.

### Internal Links
- /insights/lexikon/zielvereinbarung/, /digitale-personalakte, /dokumentenmanagement.

### PAA Handling
- PAA judged on-topic (HR-focused). No `paa-questions-manual.json` created.
- Curated faq-questions.json: replaced auto-generated nonsense questions (e.g. "Was kostet Jahresgespräch?", "Wie berechnet man...") with 12 HR-focused PAA questions.
- Added "Was sagt man im Jahresgespräch?" sentence to cover PAA and pass validate-content-completeness.

### Scene Type
- **DESK** – Distinct from zielvereinbarung (SILHOUETTES), mitarbeiterbindung (CAFE), employee-engagement (CAFE). Two people at desk, structured conversation, annual review context.

### FAQ
- 11 FAQs added (12 generated; "Was ist ein Jahresgespräch?" skipped as H2-overlapping).
- All answers 40–80 words via generate-faq-answers-optimized.php --use-ai.

### Lexikon Inventory
- Run `normalize-and-match-terms.py`, `generate-lexikon-inventory-report.py` to remove Jahresgespräch from LEXIKON_CONTENT_GAPS (was Priority 1, 12 sources).

## Deployment Notes (2026-02-23)

- **Content:** 9 H2s, 1178 words, table (3 phases), lists. Applied via update-post-content.php.
- **Featured image:** DESK scene, two people at desk, professional office, soft light. WebP variants at /insights/bilder/jahresgespraech-*.webp.
- **SEO meta:** Title "Jahresgespräch: Ablauf, Vorbereitung & Recht" (47 chars), description 150–160 chars. Added to seo-meta.json; ran sync-meta-to-posts.php.
- **Lead capture:** generate-lead-capture-copy.php --write.
- **Featured image alt:** fix-featured-image-alt.php applied ("Jahresgespräch: Ablauf, Vorbereitung & Recht | Ordio").
- **Contextual links:** TVöD tool link added in Rechtliche Grundlagen ("im TVöD für den öffentlichen Dienst" → link to /tools/tvoed-sue-gehaltsrechner).

## Content Expansion (2026-02-23)

- **Word count:** 1,178 → 1,393 (+215 words).
- **Format improvements:** Gehalt-Hinweis als blog-note blockquote; Fehler vs. Best Practice Tabelle (wie zielvereinbarung); H3s für Vorbereitung (Mitarbeiter/Führungskräfte) und Beispiele für Formulierungen.
- **Substantive additions:** Typischer Zeitpunkt (Jahresanfang/-ende); Halbjahresgespräch-Erwähnung; SMART-Reminder in Phase 2; Vorbereitungs-Checklisten (ol); drei Beispielformulierungen für PAA "welche beispiele gibt es für kommentare zum jahresgespräch?".
- **Validation:** validate-section-depth.php PASS; validate-content-completeness.php COMPLETE (25/25 PAA, tables, lists).