# Topic Hub Page Specifications

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

Design specifications for topic hub pages that will serve as central navigation points for related blog content.

## Overview

Topic hub pages are central pages for major topics that aggregate related blog posts, provide topic overviews, and improve internal linking structure. This document specifies the structure, content, and SEO requirements for these pages.

## Hub Page Strategy

### Purpose

1. **Central Navigation**: Hub for all posts about a topic
2. **SEO Value**: Target topic keywords
3. **User Experience**: Easy discovery of related content
4. **Internal Linking**: Natural link target from blog posts

### Target Topics for Hub Pages

**Priority 1 (Critical)**:

1. **Personalverwaltung** (146 occurrences, bridges 8 clusters)
2. **Dienstplan** (108 occurrences, bridges 7 clusters)
3. **Compliance** (79 occurrences, bridges 7 clusters)
4. **Zeiterfassung** (69 occurrences, bridges 6 clusters)

**Priority 2 (High)**: 5. **Gastronomie** (62 occurrences) 6. **Software Tools** (60 occurrences, bridges 7 clusters) 7. **Lohnabrechnung** (59 occurrences)

## Hub Page Structure

### Page Layout

```
Header (Site Navigation)
├── Hub Hero Section
│   ├── Topic Title (H1)
│   ├── Topic Description
│   └── Key Statistics
├── Topic Overview Section
│   ├── What is [Topic]?
│   ├── Why is [Topic] Important?
│   └── Key Concepts
├── Related Posts Grid
│   ├── Latest Posts (6-8 posts)
│   ├── Popular Posts (4-6 posts)
│   └── All Posts Link
├── Topic Subtopics
│   ├── Subtopic 1 (with posts)
│   ├── Subtopic 2 (with posts)
│   └── ...
├── Related Topics Section
│   ├── Links to related topic hubs
│   └── Cross-topic navigation
└── Footer
```

### Content Requirements

#### Hero Section

**H1**: "[Topic] - Alles was du wissen musst"

**Description**: 2-3 sentence overview of the topic

**Statistics**:

- Number of posts about topic
- Last updated date
- Key subtopics count

#### Topic Overview

**Content**:

- Definition of topic
- Importance/relevance
- Key concepts
- Common questions

**Length**: 300-500 words

**SEO**: Target topic keywords naturally

#### Related Posts Grid

**Organization**:

- Latest posts first
- Grouped by subtopics
- Filterable by category (Lexikon, Ratgeber)

**Display**:

- Post cards with:
  - Featured image
  - Title
  - Excerpt
  - Category badge
  - Publication date

**Count**: 10-15 posts visible, link to full archive

#### Topic Subtopics

**Structure**:

- List of subtopics
- Posts per subtopic
- Links to subtopic pages (if created)

**Example** (Personalverwaltung):

- Mitarbeiterverwaltung (X posts)
- Personalakte (X posts)
- Personalmanagement (X posts)

#### Related Topics Section

**Content**:

- Links to related topic hubs
- Cross-topic relationships
- "Siehe auch" navigation

## URL Structure

### Proposed URLs

**Option 1: Topic-based** (Recommended)

- `/insights/topics/personalverwaltung/`
- `/insights/topics/dienstplan/`
- `/insights/topics/zeiterfassung/`

**Option 2: Category-based**

- `/insights/personalverwaltung/`
- `/insights/dienstplan/`
- `/insights/zeiterfassung/`

**Recommendation**: Use Option 1 to avoid conflicts with existing structure

## SEO Requirements

### Meta Tags

**Title**: "[Topic] - Alles was du wissen musst | Ordio Blog"

**Description**: "Erfahre alles über [Topic]. [X] Artikel, Tipps und Ratgeber zu [Topic] für deinen Betrieb. Jetzt entdecken!"

**Keywords**: Topic name, related keywords

### Schema Markup

**WebPage Schema**:

```json
{
  "@type": "WebPage",
  "name": "[Topic] Hub",
  "description": "...",
  "breadcrumb": {...}
}
```

**CollectionPage Schema**:

```json
{
  "@type": "CollectionPage",
  "name": "[Topic] Articles",
  "description": "...",
  "numberOfItems": X
}
```

### Heading Structure

- H1: Topic title
- H2: Topic overview sections
- H3: Subtopic sections
- H4: Post groups

## Content Requirements

### Topic Overview Content

**Required Sections**:

1. **What is [Topic]?**

   - Definition
   - Key concepts
   - Relevance

2. **Why is [Topic] Important?**

   - Benefits
   - Use cases
   - Impact

3. **Key Concepts**
   - Main subtopics
   - Related topics
   - Common questions

### Post Selection

**Criteria**:

- Posts with topic in topics list
- Posts from relevant clusters
- High-quality posts (excellent rating)
- Recent posts prioritized

**Organization**:

- By subtopic
- By category (Lexikon, Ratgeber)
- By recency
- By popularity

## Internal Linking Strategy

### Links FROM Hub Pages

**To Blog Posts**:

- Link to all related posts
- Use post titles as anchor text
- Organize by subtopic

**To Related Hubs**:

- Link to related topic hubs
- Use topic names as anchor text
- Create topic network

**To Site Pages**:

- Link to relevant product pages
- Link to relevant pillar pages
- Link to relevant templates

### Links TO Hub Pages

**From Blog Posts**:

- Link from posts about topic
- Use topic name as anchor text
- First mention of topic

**From Other Hubs**:

- Cross-link related topic hubs
- Create topic network

**From Site Pages**:

- Link from relevant pages
- Use topic name as anchor text

## Implementation Requirements

### Data Structure

**Hub Page Data**:

```json
{
  "topic": "personalverwaltung",
  "title": "Personalverwaltung",
  "description": "...",
  "posts": [...],
  "subtopics": [...],
  "related_topics": [...],
  "statistics": {
    "post_count": 58,
    "last_updated": "2026-01-09"
  }
}
```

### Template Requirements

**Components Needed**:

- Hub hero component
- Topic overview component
- Post grid component
- Subtopic navigation component
- Related topics component

**Responsive Design**:

- Mobile-friendly layout
- Responsive grid
- Touch-friendly navigation

## Priority Implementation Order

### Phase 1: Critical Hubs (Weeks 1-2)

1. **Personalverwaltung Hub**

   - Highest priority (bridges 8 clusters)
   - 58 posts to link
   - Critical for SEO

2. **Dienstplan Hub**
   - High priority (bridges 7 clusters)
   - 22 posts to link
   - Critical for SEO

### Phase 2: High Priority Hubs (Weeks 3-4)

3. **Compliance Hub**

   - High priority (bridges 7 clusters)
   - 30 posts to link

4. **Zeiterfassung Hub**
   - High priority (bridges 6 clusters)
   - 21 posts to link

### Phase 3: Additional Hubs (Weeks 5-6)

5. **Gastronomie Hub**
6. **Software Tools Hub**
7. **Lohnabrechnung Hub**

## Success Metrics

### SEO Metrics

- Hub pages ranking for topic keywords
- Increased internal link equity
- Improved topic cluster structure

### User Engagement

- Hub page traffic
- Time on hub pages
- Click-through to posts
- Bounce rate

### Internal Linking

- Links from blog posts to hubs
- Links between hubs
- Improved link structure

## Related Documentation

- [Topic Analysis](TOPIC_ANALYSIS.md) - Topic extraction and taxonomy
- [Topic Overlaps](TOPIC_OVERLAPS.md) - Topic overlap analysis
- [Link Implementation Guide](LINK_IMPLEMENTATION_GUIDE.md) - Link implementation
- [Migration Template Requirements](MIGRATION_TEMPLATE_REQUIREMENTS.md) - Template specs