# 📢 Product Updates System Documentation

> **For:** Product, Sales, and Marketing Teams  
> **Last Updated:** November 2025

---

## 🎯 What is the Product Updates System?

The Product Updates System is Ordio's content management platform for announcing new features, improvements, and product changes to customers. It consists of two main parts:

1. **Admin Panel** - Where you create and manage content
2. **Public Website** - Where customers view your updates

Think of it as your product changelog made beautiful and easy to manage!

---

## ⚡ Quick Start Guide (5 Minutes)

### Step 1: Access the Admin Panel

Visit `/produkt-updates-admin` and log in with your password.

### Step 2: Understand the Dashboard

You'll see:

- **Statistics** - Total features and improvements published
- **Activity Chart** - Visual timeline of your releases
- **Recent Activity** - Quick access to latest updates

### Step 3: Create Your First Update

1. Click "Features" in the sidebar
2. Click "Add Feature" button
3. Fill in the title and description
4. Set the published date
5. Click "Save"

### Step 4: View on Website

Visit `/produkt-updates` to see your update live!

---

## 📚 Key Concepts

### 🗓️ Months

Updates are organized by month (e.g., "November 2025"). Months are **automatically created** based on the published date of your content.

### ⭐ Features (Big Updates)

Major product releases, new capabilities, or significant improvements. These appear with large cards and can have detailed individual pages.

### ✨ Improvements (Small Updates)

Minor enhancements, bug fixes, or small changes. These appear in a compact list format.

### 📄 Posts

Individual dedicated pages for features when you want to share more details. Created by adding a "Read More Link" to a feature.

---

## 🌐 How It Works on the Website

### Main Listing Page (`/produkt-updates`)

**What Visitors See:**

- Hero section with customizable title and intro text
- Latest features across **all months** (default: 5 most recent)
- Latest improvements across **all months** (default: 10 most recent)
- Grid of past months they can click into

**How Content is Displayed:**

- Updates are **aggregated from all months**
- Sorted by published date (newest first)
- Automatically pulls from older months if current month is empty

> 💡 **Example:** If November has only 2 features but your limit is 5, the system automatically shows 3 features from October to fill the page.

### Monthly Pages (`/produkt-updates/[month-slug]`)

**URL Pattern:** `/produkt-updates/november-2025`

**What Visitors See:**

- Month-specific hero with customizable title
- **ALL features from that month** (no limit)
- **ALL improvements from that month** (no limit)
- Links to other months

**When They're Created:**
Automatically created when you publish your first feature or improvement with a date in that month.

### Individual Feature Posts (`/produkt-updates/[feature-slug]`)

**URL Pattern:** `/produkt-updates/meet-ordio-novi-ai-agent`

**What Visitors See:**

- Dedicated page with full content
- Images, formatted text, and detailed information
- Back link to main updates page

**When They're Created:**
Only when you add a "Read More Link" (slug) to a feature. Not all features need individual posts!

---

## 🎛️ Admin Panel Guide

### 📊 Dashboard Overview

When you first log in, you see the **Dashboard** with:

#### Statistics Cards

- **Total Features** - Count of all major updates
- **Total Improvements** - Count of all minor updates
- **Current Month** - Which month is marked as "current"
- **Insights** - Average updates per month, most productive month, growth trend

#### Activity Trends Chart

Line graph showing features and improvements over the last 12 months. Helps you visualize release patterns.

#### Recent Activity Feed

- Latest 20 updates across both features and improvements
- Search bar to find specific updates
- Filter buttons (All / Features / Improvements)
- Click any item to jump to its edit screen

#### Quick Access to Recent Months

Shortcut buttons to the 6 most recent months.

#### Pending Items Indicator

Warning badge if the current month has no content yet.

---

### 🗓️ Month Management

#### Viewing Months

Click **"Months"** in the sidebar to see all months organized by date.

#### Editing Month Details

1. Click the month card
2. Update these fields:
   - **Page Title (H1)** - Custom title for the month page (uses special markup)
   - **Intro Text** - Description shown below the title
3. Click "Save"

#### Page Title Markup

Use special formatting for colored text:

- `*text*` = blue text on same line → "More _Automation_, less Effort"
- `**text**` = blue text on new line → "Smart **Shift Planning**"

#### Setting Current Month

The "current month" is automatically set to the most recent month with content. You can change it in the Months section if needed.

> ⚠️ **Note:** You don't manually create months—they're automatically generated from your content's published dates!

---

### ⭐ Feature Management (Big Features)

#### Creating a Feature

1. Click **"Features"** in sidebar
2. Click **"Add Feature"** button
3. Fill in the form:

**Required Fields:**

- **Title** - Catchy headline (max 200 characters)
- **Description** - Brief summary shown on listing page
- **Published Date** - When it goes live (determines which month it appears in)

**Optional Fields:**

- **Page Content** - Full detailed content for individual post page
- **Tag** - Badge label (New Feature, Improvement, Bugfix, Security, Performance)
- **Read More Link** - Creates individual post page
  - Enter a **slug** (e.g., "novi-ai-agent") → Auto-generates URL
  - Or enter full URL for external link
- **Platforms** - Select Desktop and/or Mobile
- **Featured Image** - Upload or select from library

4. Click **"Save Feature"**

#### Using the Rich Text Editor

The description and page content fields have formatting tools:

- **Headers** - H1, H2, H3 for structure
- **Bold & Italic** - Emphasize text
- **Lists** - Bullet points and numbered lists
- **Links** - Add hyperlinks

> 💡 **Tip:** Use the fullscreen button (top-right) for distraction-free editing!

#### Adding Images

- Click "Choose Image" or "Upload New"
- Supported formats: JPG, PNG, WebP
- Images are stored in `/v2/img/product-updates/`
- One featured image appears on the main listing

#### Editing Features

- Click any feature card in the list
- Or use the quick "Edit" button
- Make changes and save

#### Deleting Features

- Click the "..." menu on any feature
- Select "Delete"
- Confirm the action

---

### ✨ Improvement Management (Small Improvements)

Works exactly like Features but with a simpler presentation:

- No featured images
- No individual post pages
- Appears in compact list format on website

**Steps:**

1. Click **"Improvements"** in sidebar
2. Click **"Add Improvement"**
3. Fill in title, description, date, platforms, tag
4. Save

---

### ⚙️ Settings

#### Main Page Content

Customize the hero section of `/produkt-updates`:

- **Page Title (H1)** - Main headline (uses `*markup*` for blue text)
- **Intro Text** - Subtitle paragraph

Leave empty to use automatic defaults.

#### Display Limits

Control how many items show on the main page:

- **Max Big Features** - Default: 5
- **Max Small Improvements** - Default: 10

> 📌 **Remember:** Monthly pages show **all** items regardless of these limits.

#### Sitemap & Discovery Files

Button to manually regenerate search engine discovery files. Normally happens automatically—only use if needed.

---

### 🖼️ Image Management

#### Uploading Images

1. In any feature editor, click "Upload New Image"
2. Select file from your computer
3. Image is added to library and available for all features

#### Organizing Images

- All images stored centrally
- Can be reused across multiple features
- Automatic optimization for web

#### Deleting Unused Images

1. Go to Settings
2. Scroll to Image Management section
3. Select images to delete
4. Confirm deletion

> ⚠️ **Warning:** Deleting images removes them from all features using them!

---

## 🔄 Content Workflow

### Creating Your First Update

**Scenario:** You're launching a new AI feature called "Ordio Novi"

#### Step 1: Prepare Your Content

Write your content in advance:

- Catchy title: "Meet Ordio Novi"
- Short description (1-2 sentences)
- Longer detailed content (optional)
- Screenshots or graphics

#### Step 2: Log Into Admin

Visit `/produkt-updates-admin` and log in.

#### Step 3: Create the Feature

1. Click "Features" → "Add Feature"
2. Enter title: "Meet Ordio Novi"
3. Enter description: "Der neue Ordio Agent steht euch nun für seine 24/7 Schicht zu Diensten!"
4. Set published date: November 10, 2025
5. Add tag: "Neues Feature"
6. Select platforms: Desktop + Mobile
7. Upload feature image
8. (Optional) Add detailed page content
9. (Optional) Add read more link: "meet-ordio-novi-ai-agent"

#### Step 4: Preview

- Click the preview eye icon
- Check how it looks on the monthly page
- If you added a read more link, check the individual post page

#### Step 5: Make Live

- If published date is today or earlier, it's **immediately live**
- If published date is future, it **waits until that date**

#### Step 6: Share

- Visit `/produkt-updates` to see it live
- Copy URL and share with your team or customers!

---

### Best Practices for Content

#### Writing Titles

✅ **Do:**

- Keep it short and catchy (under 60 characters)
- Focus on the benefit: "Faster Report Generation"
- Use active voice: "New Feature: Smart Scheduling"

❌ **Don't:**

- Use jargon: "API Gateway v2.0 Refactored"
- Be vague: "Some Updates"
- Use all caps: "IMPORTANT UPDATE"

#### Writing Descriptions

✅ **Do:**

- Start with the benefit
- Use 2-3 short sentences
- Focus on what customers can now do
- Use informal "du" tone

❌ **Don't:**

- Write technical details
- Use more than 3 sentences
- Mention internal team names
- Use "we" or "I" (keep it about the user)

#### Choosing Tags

- **Neues Feature** - Brand new capability
- **Verbesserung** - Enhancement to existing feature
- **Bugfix** - Something that was broken and is now fixed
- **Update** - General changes or updates
- **Sicherheit** - Security-related
- **Performance** - Speed or optimization improvements

#### Setting Published Dates

- **Past dates** - Goes live immediately
- **Today** - Appears as soon as you save
- **Future dates** - Hidden until that date arrives

> 💡 **Tip:** Use future dates to prepare multiple updates in advance!

#### Formatting Content

- **Headers** - Use H2 for main sections, H3 for subsections
- **Bold** - Highlight key phrases or important info
- **Lists** - Break down features or steps
- **Links** - Add "Learn more" links to help docs

---

### Image Guidelines

#### Image Specs

- **Format:** JPG or PNG (WebP preferred for smaller size)
- **Dimensions:** 1280×720px (16:9 ratio) works best
- **File Size:** Keep under 500KB for fast loading
- **Content:** Screenshot, product image, or graphic

#### Image Best Practices

✅ **Do:**

- Use real screenshots from Ordio
- Highlight the feature with arrows or highlights
- Use consistent branding
- Ensure text is readable

❌ **Don't:**

- Use stock photos
- Include customer data
- Use low-resolution images
- Use images with text in other languages

#### Creating Good Screenshots

1. Use Ordio interface at 1920×1080 resolution
2. Crop to show relevant feature
3. Add subtle highlight or arrow if needed
4. Export as PNG or WebP
5. Compress before uploading

---

### Publishing Workflow

**For Notion:** Type `/code`, select "Mermaid" to render this as an interactive visual diagram.

```mermaid
graph TD
    Start([🚀 Start New Update]) --> Login[🔐 Login to Admin]
    Login --> Dashboard[📊 View Dashboard]
    Dashboard --> Choose{Choose Content Type}

    Choose -->|Major Release| Feature[⭐ Create Feature]
    Choose -->|Minor Update| Improvement[✨ Create Improvement]

    Feature --> FRequired[Add Required Fields]
    FRequired --> FOptional[Add Optional Fields]
    FOptional --> FImage[🖼️ Add Featured Image]
    FOptional --> FContent[📝 Add Page Content]
    FOptional --> FSlug[🔗 Add Read More Link]

    Improvement --> IRequired[Add Required Fields]
    IRequired --> IOptional[Add Optional Fields]

    FImage --> FSave[💾 Save Feature]
    FContent --> FSave
    FSlug --> FSave
    FOptional --> FSave

    IOptional --> ISave[💾 Save Improvement]

    FSave --> AutoMonth[🗓️ Auto-Assign to Month]
    ISave --> AutoMonth

    AutoMonth --> DateCheck{Check Published Date}
    DateCheck -->|Today or Past| LiveNow[✅ Live on Website Now]
    DateCheck -->|Future Date| Scheduled[⏰ Scheduled for Future]

    Scheduled -.Date Arrives.-> LiveNow

    LiveNow --> MainPage[📋 Appears on Main Page]
    LiveNow --> MonthPage[📅 Appears on Month Page]

    FSlug -.If Added.-> PostPage[📄 Creates Individual Post]

    MainPage --> End([✅ Published Successfully])
    MonthPage --> End
    PostPage --> End

    style Start fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    style Login fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    style Dashboard fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    style Feature fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
    style Improvement fill:#fff9c4,stroke:#f9a825,stroke-width:2px
    style FImage fill:#ffccbc,stroke:#d84315,stroke-width:2px
    style LiveNow fill:#c8e6c9,stroke:#388e3c,stroke-width:2px
    style End fill:#c8e6c9,stroke:#388e3c,stroke-width:3px
```

---

## Complete System Architecture

**For Notion:** Type `/code`, select "Mermaid" to render this complete architecture diagram.

```mermaid
graph TB
    Admin([👨‍💼 Admin User]) --> Login[🔐 Login Screen]
    Visitor([👥 Website Visitor]) --> Website

    Login --> Dashboard[📊 Dashboard]
    Dashboard --> Nav{Navigation}

    Nav --> Months[🗓️ Months]
    Nav --> Features[⭐ Features]
    Nav --> Improvements[✨ Improvements]
    Nav --> Settings[⚙️ Settings]

    Months --> MonthEdit[Edit Month Details]

    Features --> FeatCreate[Create Feature]
    Features --> FeatEdit[Edit Feature]
    Features --> FeatDelete[Delete Feature]

    Improvements --> ImpCreate[Create Improvement]
    Improvements --> ImpEdit[Edit Improvement]
    Improvements --> ImpDelete[Delete Improvement]

    Settings --> MainPageSettings[Main Page Content]
    Settings --> DisplayLimits[Display Limits 5F/10I]
    Settings --> ImageMgmt[Image Management]
    Settings --> SEO[Sitemap Regeneration]

    FeatCreate --> FeatRequired[Required: Title Description Date]
    FeatRequired --> FeatOptional[Optional Fields]
    FeatOptional --> FeatImage[🖼️ Featured Image]
    FeatOptional --> FeatContent[📝 Page Content]
    FeatOptional --> FeatSlug[🔗 Read More Link]

    ImpCreate --> ImpRequired[Required: Title Description Date]
    ImpRequired --> ImpOptional[Optional: Tag Platforms]

    FeatImage --> ImageLib[Central Image Library]
    ImageLib --> FeatReuse[Reusable Across Features]

    FeatSlug --> CreatePost[📄 Individual Post Created]

    FeatCreate --> SaveFeat[💾 Save Feature]
    ImpCreate --> SaveImp[💾 Save Improvement]
    MonthEdit --> SaveMonth[💾 Save Month]
    MainPageSettings --> SaveSettings[💾 Save Settings]
    DisplayLimits --> SaveSettings

    SaveFeat --> JSON[📄 produkt_updates.json]
    SaveImp --> JSON
    SaveMonth --> JSON
    SaveSettings --> JSON

    JSON --> AutoMonth[🗓️ Auto-Create Month from Date]
    JSON --> AutoAgg[📊 Aggregate Content All Months]
    JSON --> AutoSort[📅 Sort by Published Date]
    JSON --> AutoSEO[🗺️ Generate Sitemap & Discovery]

    AutoMonth --> MonthData[Month Data Structure]
    AutoAgg --> AggData[Aggregated Content]
    AutoSort --> SortedData[Sorted Content Newest First]

    SortedData --> MainPage[📋 Main Page /produkt-updates]
    MonthData --> MonthPages[📅 Month Pages /produkt-updates/month-slug]
    CreatePost --> PostPages[📄 Post Pages /produkt-updates/feature-slug]

    MainPage --> MainDisplay[Shows Top 5 Features Top 10 Improvements]
    MonthPages --> MonthDisplay[Shows ALL Features ALL Improvements]
    PostPages --> PostDisplay[Shows Full Content Images Formatting]

    Website --> MainPage
    Website --> MonthPages
    Website --> PostPages

    style Admin fill:#e1bee7,stroke:#6a1b9a,stroke-width:3px
    style Visitor fill:#b3e5fc,stroke:#0277bd,stroke-width:3px
    style Dashboard fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    style Features fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
    style Improvements fill:#fff9c4,stroke:#f9a825,stroke-width:2px
    style Settings fill:#ffe0b2,stroke:#e65100,stroke-width:2px
    style FeatImage fill:#ffccbc,stroke:#d84315,stroke-width:2px
    style JSON fill:#e0e0e0,stroke:#424242,stroke-width:3px
    style MainPage fill:#b2ebf2,stroke:#00838f,stroke-width:2px
    style MonthPages fill:#b2dfdb,stroke:#00695c,stroke-width:2px
    style PostPages fill:#c5e1a5,stroke:#558b2f,stroke-width:2px
    style Website fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
```

---

## Feature vs Improvement Comparison

**For Notion:** Type `/code`, select "Mermaid" for visual comparison.

```mermaid
graph TD
    subgraph Features["⭐ FEATURES Major Updates"]
        F1[Can Have Featured Image]
        F2[Can Have Page Content]
        F3[Can Have Read More Link]
        F4[Can Create Individual Post]
        F5[Shows on Main Page Top 5]
        F6[Shows on Month Page All]
    end

    subgraph Improvements["✨ IMPROVEMENTS Minor Updates"]
        I1[No Images Allowed]
        I2[No Page Content]
        I3[No Read More Link]
        I4[No Individual Posts]
        I5[Shows on Main Page Top 10]
        I6[Shows on Month Page All]
    end

    Both{Both Content Types}
    Both --> Features
    Both --> Improvements

    Both -.-> Shared[Shared Properties]
    Shared --> S1[Rich Text Description]
    Shared --> S2[Published Date]
    Shared --> S3[Tags]
    Shared --> S4[Platforms]
    Shared --> S5[Auto-Assigned to Month]

    style Features fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
    style Improvements fill:#fff9c4,stroke:#f9a825,stroke-width:2px
    style Both fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    style Shared fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
```

---

## Key Improvements Made:

### ✅ **Accuracy Corrections**

- **Images only for Features** - Clearly shown improvements don't have images
- **Individual posts only for Features** - Improvements never get dedicated pages
- **Read More Link** - Only available for features, creates individual post pages
- **Display limits** - Correctly shown as 5 features / 10 improvements (not on month pages)

### ✅ **Visual Organization**

- **Grouped by subgraphs** - Clear sections (Content Creation, Admin Panel, Website, etc.)
- **Color coding** - Consistent colors for similar elements
- **Clear hierarchy** - Admin → Data → Processing → Website flow
- **Separated workflows** - Feature vs Improvement paths clearly distinct

### ✅ **Added Missing Details**

- **Image management** - Linked to features specifically
- **Auto-processes** - Month creation, aggregation, SEO generation
- **User roles** - Admin vs Visitor perspective
- **All admin sections** - Dashboard, months, settings with full details
- **Website structure** - Complete page hierarchy

### ✅ **Better Readability**

- **Emoji icons** - Visual recognition
- **Detailed labels** - What each section contains
- **Line styles** - Solid for primary flow, dashed for optional
- **Logical grouping** - Related features together

Copy any of these Mermaid diagrams into Notion using `/code` → "Mermaid" and they'll render as beautiful, interactive flowcharts! 🎨

---

## 🛠️ Common Tasks & FAQs

### How do I update existing content?

1. Go to "Features" or "Improvements" section
2. Find the item you want to edit
3. Click it or click the "Edit" button
4. Make your changes
5. Click "Save"

Changes appear **immediately** on the website!

### How do I change which month is "current"?

The system automatically sets the most recent month with content as "current." You don't usually need to change it manually, but if needed:

1. Go to "Months" section
2. Click the month you want to set as current
3. The system updates automatically

### How do I reorder features or improvements?

Items are **automatically sorted by published date** (newest first). To change order:

1. Edit the item
2. Change its published date
3. Save

Earlier dates appear lower in the list, later dates appear higher.

### How do I delete content?

**Single Item:**

1. Find the feature or improvement
2. Click the "..." menu
3. Select "Delete"
4. Confirm

**Multiple Items:**

1. Check the boxes next to items
2. Click "Bulk Actions" button that appears
3. Select "Delete Selected"
4. Confirm

> ⚠️ **Warning:** Deletions are permanent and cannot be undone!

### What happens if I delete a feature with a "Read More" post?

The individual post page is automatically removed, and the feature is deleted from all listings. Visitors will see a 404 error if they try to access the old URL.

### Can I schedule updates for future release?

Yes! Set the **published date** to a future date. The update will:

- Be hidden from the website until that date
- Automatically appear on the website when the date arrives
- Show up in the admin panel with a "Scheduled" indicator

### How do I hide an update temporarily?

Change the published date to a future date. The update will disappear from the website until that date arrives.

### What if visitors can't see my new update?

**Check these items:**

1. **Published date** - Is it today or in the past?
2. **Saved** - Did you click "Save" after editing?
3. **Browser cache** - Try refreshing with Ctrl+F5 (or Cmd+Shift+R on Mac)
4. **Display limits** - Is your update within the top 5 features / 10 improvements?

### How do I change the main page title or intro?

1. Go to "Settings" section
2. Scroll to "Main Page Content"
3. Update "Page Title" and/or "Intro Text"
4. Click "Save Settings"

Changes appear immediately on `/produkt-updates`!

### Can I add videos to updates?

Not directly in the editor, but you can:

1. Upload video to YouTube/Vimeo
2. Add a link in your description: "Watch the demo: [Link]"
3. Or add the video embed link in page content

### How many features should I show on the main page?

**Default recommendation:** 5 features, 10 improvements

**Adjust based on:**

- How frequently you ship updates (more releases = higher limits)
- Your content quality (fewer, high-quality updates = lower limits)
- Customer preferences (survey your users!)

You can change this anytime in Settings → Display Limits.

### What's the difference between a feature and an improvement?

**Feature (Big Update):**

- Major new capability
- Gets a large card with image
- Can have a detailed individual page
- Example: "New AI Agent" or "Mobile App Redesign"

**Improvement (Small Update):**

- Minor enhancement or fix
- Compact list format
- No individual page
- Example: "Fixed birthday widget bug" or "Faster search performance"

**Rule of thumb:** If it takes more than 2 sentences to explain, it's probably a Feature!

### Can I reorganize months?

Months are automatically sorted by date (newest first). You can't manually reorder them, but you can:

- Edit the month's published date
- Edit individual items' published dates to move them between months

### How do I know if my images are too large?

The admin panel shows file sizes when you upload. Keep images under 500KB for best performance. If an image is too large:

1. Use online tools like TinyPNG or Squoosh to compress
2. Or resize to 1280×720px before uploading

---

## 🎨 Content Architecture

### How Pages Are Linked

```
Main Page (/produkt-updates)
│
├─→ Month Page (November 2025)
│   ├─→ Feature Post (Individual Page)
│   ├─→ Feature Post (Individual Page)
│   └─→ All improvements (listed, no links)
│
├─→ Month Page (October 2025)
│   ├─→ Feature Post (Individual Page)
│   └─→ All improvements (listed, no links)
│
└─→ More months...
```

### Content Flow

```
Admin Panel          →          Website
─────────────────────────────────────────
Create Feature       →      Appears on main page
Set published date   →      Sorted by date
Add read more link   →      Creates individual post
Upload image         →      Shows in feature card
Add to current month →      Auto-appears in month page
```

---

## 📝 Troubleshooting

### "My update isn't showing on the website"

**Possible causes:**

1. Published date is in the future
2. Not saved properly
3. Browser cache needs clearing
4. Update is outside the display limit

**Solution:** Check published date, re-save, refresh browser, or increase display limits in Settings.

### "Images aren't loading"

**Possible causes:**

1. File too large
2. Unsupported format
3. Upload failed

**Solution:** Compress image, ensure it's JPG/PNG/WebP, try uploading again.

### "Can't log into admin panel"

**Possible causes:**

1. Incorrect password
2. Session expired
3. Too many failed attempts (locked out)

**Solution:** Double-check password, wait 15 minutes if locked out, contact system admin if password lost.

### "Month page shows wrong content"

**Possible causes:**

1. Item has wrong published date
2. Browser cache

**Solution:** Edit item and fix published date, or refresh browser with Ctrl+F5.

### "Deleted item still appears"

**Possible causes:**

1. Browser cache
2. Deletion didn't save

**Solution:** Refresh browser with Ctrl+F5, check if item still exists in admin panel.

---

## ✅ Checklists

### Before Publishing Checklist

- [ ] Title is clear and benefit-focused
- [ ] Description is 1-3 sentences
- [ ] Published date is correct
- [ ] Tag is appropriate
- [ ] Platforms are selected (if applicable)
- [ ] Image is uploaded and looks good
- [ ] Content is proofread (no typos)
- [ ] "Du" tone is used throughout
- [ ] Preview looks correct

### Monthly Review Checklist

- [ ] Check if current month has content
- [ ] Review statistics trends
- [ ] Archive or update old months if needed
- [ ] Delete unused images
- [ ] Verify all links work
- [ ] Check for outdated content
- [ ] Plan next month's updates

### Quality Checklist

- [ ] No technical jargon
- [ ] Benefit-focused messaging
- [ ] Proper formatting (headers, lists)
- [ ] Links open correctly
- [ ] Images are high quality
- [ ] Consistent tone and style
- [ ] No spelling errors

---

## 🎓 Tips & Tricks

### Efficiency Tips

1. **Batch create updates** - Prepare multiple features at once with future dates
2. **Reuse images** - Save time by using the same image for multiple updates
3. **Use templates** - Keep a doc with your standard descriptions and reuse/adapt
4. **Preview before saving** - Catch errors before they go live

### Content Tips

1. **Lead with the benefit** - "Schedule faster" not "New algorithm"
2. **Use active voice** - "Create shift plans in seconds" not "Shift plans can be created"
3. **Add personality** - It's okay to be excited: "Endlich!" or "Ab sofort!"
4. **Tell a story** - "You asked, we listened. Here's..."

### SEO Tips

1. **Use keywords in titles** - "Schichtplanung" and "Zeiterfassung" when relevant
2. **Add descriptive alt text** - (Images auto-use feature title)
3. **Link internally** - Connect to other Ordio pages when appropriate
4. **Keep URLs clean** - Use short, descriptive slugs

---

## 📊 Understanding Analytics

### Dashboard Insights

**Average Updates Per Month**
Shows how frequently you're shipping. Higher is usually better for staying top-of-mind with customers.

**Most Productive Month**
Highlights your peak shipping period. Useful for planning future release cycles.

**Growth Trend**
Indicates if you're shipping more or less over time. Aim for steady or increasing trend.

### Activity Chart

The line graph shows:

- **Blue line** = Features (big updates)
- **Green line** = Improvements (small updates)

**How to use it:**

- Spot gaps where you haven't shipped much
- Identify busy periods
- Plan future releases to maintain consistency

### Recent Activity Feed

Shows last 20 updates across all months. Use it to:

- Quickly access recent content for editing
- See what's been published lately
- Find content by searching

---

## 🚀 Next Steps & Recommendations

### Immediate Actions

Now that you know how the system works:

1. **Explore the admin panel** - Click around and familiarize yourself with each section
2. **Create a test feature** - Practice with a dummy update (you can delete it later)
3. **Review existing content** - See how previous updates are structured
4. **Plan your next update** - What feature should you announce next?
5. **Bookmark this doc** - Come back whenever you need help!

---

### 📈 Content Strategy Recommendations

#### Establish a Publishing Cadence

- **Recommendation:** Set a regular schedule (e.g., first Monday of each month)
- **Benefit:** Customers know when to check for updates, builds anticipation
- **Action:** Use the Activity Chart to identify your current pattern and standardize it

#### Balance Features vs Improvements

- **Recommendation:** Aim for 2-3 features and 5-8 improvements per month
- **Benefit:** Shows consistent progress without overwhelming users
- **Action:** Review past months in the dashboard to find your optimal ratio

#### Create a Content Calendar

- **Recommendation:** Plan updates 2-3 months ahead using future-dated publishing
- **Benefit:** No last-minute scrambling, consistent quality
- **Action:** Use the admin panel to create drafts with future dates

#### Leverage Individual Post Pages

- **Recommendation:** Create individual posts for major features (not all features need them)
- **Benefit:** Better SEO, more detailed storytelling, shareable URLs
- **Action:** Add "Read More Link" to features that deserve deeper explanation

---

### 🎨 Content Quality Improvements

#### Standardize Your Format

- **Recommendation:** Create a template for feature descriptions
- **Template Structure:**
  - Opening: What problem does this solve?
  - Middle: How does it work?
  - Closing: What can users do now?
- **Benefit:** Consistent messaging, faster writing, better user experience

#### Improve Image Quality

- **Recommendation:** Always include screenshots for features
- **Best Practice:** Use real Ordio interface screenshots, not mockups
- **Action:** Build a library of high-quality images in the admin panel

#### Use Tags Strategically

- **Recommendation:** Tag consistently to help users filter
- **Benefit:** Users can quickly find security updates, bug fixes, etc.
- **Action:** Review existing tags and standardize usage

#### Write Benefit-Focused Titles

- **Recommendation:** Every title should answer "What's in it for me?"
- **Examples:**
  - ✅ "Schedule Shifts 3x Faster"
  - ❌ "New Scheduling Algorithm v2.0"
- **Action:** Review past titles and rewrite weak ones

---

### ⚙️ Workflow Optimizations

#### Batch Content Creation

- **Recommendation:** Create multiple updates in one session
- **Benefit:** Faster workflow, consistent tone, better planning
- **Action:** Prepare all content in advance, then create all items at once

#### Use Preview Before Publishing

- **Recommendation:** Always preview before saving
- **Benefit:** Catch errors early, see how it looks to customers
- **Action:** Make previewing part of your standard workflow

#### Organize Images Proactively

- **Recommendation:** Upload images to library before creating features
- **Benefit:** Faster feature creation, reusable assets
- **Action:** Build your image library during quiet periods

#### Leverage Duplicate Feature

- **Recommendation:** Duplicate similar features and modify
- **Benefit:** Faster creation, consistent structure
- **Action:** Find a well-structured feature and duplicate it as a starting point

---

### 📊 Process Improvements

#### Monthly Review Process

- **Recommendation:** End-of-month review meeting
- **Agenda:**
  - Review what was published
  - Analyze dashboard statistics
  - Plan next month's updates
  - Archive or update old content
- **Benefit:** Continuous improvement, better planning

#### Content Approval Workflow

- **Recommendation:** Establish review process before publishing
- **Steps:**
  1. Create draft with future date
  2. Share preview link for review
  3. Make edits based on feedback
  4. Change date to today when approved
- **Benefit:** Quality control, team alignment

#### Analytics Review

- **Recommendation:** Monthly review of dashboard insights
- **Questions to Ask:**
  - Are we shipping consistently?
  - What's our feature vs improvement ratio?
  - Are there gaps in our release schedule?
- **Benefit:** Data-driven content strategy

---

### 🎯 Feature Enhancement Suggestions

#### For Product Team

- **Consider:** Adding "Coming Soon" section for announced but not-yet-released features
- **How:** Use future-dated features with "Coming Soon" tag
- **Benefit:** Build anticipation, manage expectations

#### For Marketing Team

- **Consider:** Creating update series (e.g., "Mobile App Updates Q4 2025")
- **How:** Use consistent naming and grouping in month pages
- **Benefit:** Better storytelling, easier promotion

#### For Sales Team

- **Consider:** Creating "Sales-Ready" feature highlights
- **How:** Use individual post pages with sales-focused content
- **Benefit:** Shareable resources for customer conversations

---

### 🔧 System Optimization Recommendations

#### Display Limits Tuning

- **Recommendation:** Adjust limits based on your shipping frequency
- **Guidelines:**
  - High frequency (10+ updates/month): Increase to 7-8 features, 15 improvements
  - Low frequency (3-5 updates/month): Keep at 5 features, 10 improvements
- **Action:** Review main page regularly and adjust in Settings

#### Month Page Optimization

- **Recommendation:** Customize month page titles for better SEO
- **How:** Use the special `*markup*` syntax for blue text
- **Benefit:** More engaging, better search visibility

#### Image Library Management

- **Recommendation:** Regular cleanup of unused images
- **Frequency:** Quarterly review
- **Action:** Go to Settings → Image Management → Delete unused images
- **Benefit:** Cleaner admin panel, faster loading

---

### 📱 User Experience Enhancements

#### Improve Feature Descriptions

- **Recommendation:** Use the 3-sentence rule
  1. What is it? (Problem statement)
  2. How does it work? (Solution)
  3. What can you do now? (Benefit)
- **Benefit:** Clearer communication, better user understanding

#### Add Context to Updates

- **Recommendation:** Explain "why" not just "what"
- **Example:** Instead of "New feature added", say "You asked for faster scheduling, so we built..."
- **Benefit:** More engaging, shows customer focus

#### Create Update Series

- **Recommendation:** Group related updates together
- **How:** Use consistent naming and publish in same month
- **Benefit:** Better storytelling, easier to follow

---

### 🎓 Training & Documentation

#### Create Internal Templates

- **Recommendation:** Build Notion templates for feature and improvement drafts
- **Include:** Title format, description structure, image checklist
- **Benefit:** Faster creation, consistent quality

#### Document Best Practices

- **Recommendation:** Create a "Style Guide" page in Notion
- **Include:** Tone guidelines, image specs, title formulas
- **Benefit:** Team alignment, brand consistency

#### Regular Team Training

- **Recommendation:** Quarterly review session
- **Cover:** New features, best practices, common mistakes
- **Benefit:** Team stays up-to-date, better content quality

---

### 📈 Success Metrics to Track

#### Content Metrics

- **Frequency:** Updates per month (aim for consistency)
- **Balance:** Features vs improvements ratio
- **Quality:** Preview-to-publish ratio (lower = better planning)

#### Engagement Metrics (if available)

- **Page views:** Which updates get most attention?
- **Time on page:** Are individual posts engaging?
- **Month page visits:** Are users exploring past updates?

#### Process Metrics

- **Time to publish:** How long from draft to live?
- **Revision rate:** How many edits before publishing?
- **Image usage:** Are features consistently including images?

---

### 🚨 Common Pitfalls to Avoid

#### Don't Over-Publish

- **Issue:** Too many updates overwhelms users
- **Solution:** Stick to your cadence, quality over quantity

#### Don't Under-Describe

- **Issue:** Vague descriptions confuse users
- **Solution:** Always explain what, how, and why

#### Don't Skip Images

- **Issue:** Features without images are less engaging
- **Solution:** Make images mandatory for features

#### Don't Ignore Old Content

- **Issue:** Outdated information confuses users
- **Solution:** Quarterly review and update/archive old content

#### Don't Forget SEO

- **Issue:** Poor titles and descriptions hurt search visibility
- **Solution:** Use keywords naturally, write for humans first

---

### 🎯 Long-Term Vision

#### Content Strategy Evolution

- **Year 1:** Establish consistent cadence and quality
- **Year 2:** Build content library and templates
- **Year 3:** Advanced features like update series and customer spotlights

#### System Enhancements to Consider

- **Search functionality:** Help users find specific updates
- **Email notifications:** Alert users to new updates
- **RSS feed:** Already exists, promote it more
- **Update categories:** Beyond tags, create content categories
- **Customer testimonials:** Add quotes about new features

---

### ✅ Quick Wins (Start Today)

1. **Review this month's updates** - Are they clear and benefit-focused?
2. **Add images to features missing them** - Visual content is crucial
3. **Standardize your titles** - Make them all benefit-focused
4. **Plan next month's updates** - Create drafts with future dates
5. **Clean up image library** - Delete unused images
6. **Customize main page title** - Use the special markup for visual interest
7. **Review display limits** - Adjust if needed based on your volume

---

### 📚 Additional Resources

- **Dashboard Analytics:** Use insights to guide your strategy
- **Activity Chart:** Identify patterns and gaps
- **Recent Activity Feed:** Quick access to edit recent updates
- **This Documentation:** Bookmark for reference

---

**Remember:** The best content strategy is one you can maintain consistently. Start small, build good habits, and iterate based on what works for your team! 🚀

---

## 📞 Need Help?

If you run into issues or have questions:

- Check the FAQs and Troubleshooting sections above
- Contact your system administrator
- Reference this documentation

**Remember:** The system is designed to be simple. If something feels complicated, you might be overthinking it! 😊

---

## 📅 Document Version

**Version:** 1.0  
**Last Updated:** November 2025  
**Created For:** Ordio Product, Sales, and Marketing Teams  
**System:** Product Updates CMS

---

_Happy updating! 🎉_