Introduction

Introduction

FreshPage is a new tool which can be installed in your Confluence space to help you keep your documentation accurate and valid.

Think of it as a "Best Before" date for our wiki pages. It helps you instantly know if the information you are reading is current or if it might be outdated.

The Problem We Solve

"The Knowledge Rot Cycle"

Most teams are great at creating documentation but struggle to maintain it. Over time, this leads to three specific problems:

  • Erosion of Trust: When users encounter outdated info (e.g., old server IPs, deprecated HR policies), they stop trusting any documentation in Confluence. They start asking questions in chat/Slack/Teams instead of searching the wiki, creating a bottleneck for experts.

  • Hidden Risks: Outdated "Standard Operating Procedures" (SOPs) or compliance documents can lead to operational errors or security vulnerabilities if followed blindly.

  • Maintenance Paralysis: Cleanup projects are overwhelming. Without a clear system, no one knows which of the 5,000 pages needs attention, so nothing gets updated.

Key Value Propositions

Why FreshPage is the solution

  • 🚦 Instant Visual Trust (The "Traffic Light" System): We remove the guesswork. A user opens a page and instantly knows if it is safe to use (Green) or needs caution (Red). No need to check the "Last Updated" timestamp and calculate dates mentally.

  • 🖱️ Frictionless Verification: We lower the barrier to maintenance. Updating a page's status doesn't require "Edit Mode," saving a draft, or publishing. It is a single click. This encourages "gardening" (small, frequent updates) rather than major overhauls.

  • 🔇 Smart Noise Reduction: We distinguish between "abandoned" and "completed." The Evergreen feature ensures that historical records (like Meeting Notes) don't clutter the "Stale" list, keeping the focus only on documents that must stay current.

  • ⚙️ Governance Without Micromanagement: Admins set the rules (e.g., "Critical docs expire in 30 days"), but the whole team is empowered to verify content. It distributes the workload across the organization.

🚦 How It Works

When FreshPage app is installed in your Confluence instance, every page now has a colored banner at the top showing its current status:

Status

Color

What it means

Fresh

🟢 Green

Safe to use. This content was recently verified (confirmed accurate).

Aging

🟡 Yellow

Heads up. This content hasn't been checked in a while.

Stale

🔴 Red

Be careful. This content is old and needs a review.

👤 Role of page consumer

You don't need to learn complicated settings. You just need to look at the banner.

  • If you see GREEN banner : Everything is good

  • If you see a Yellow or Red banner:

    • There might be some changes in the document and needs to be validated

    • Comment on document asking if the document is still valid, author will get notified and they can validate the freshness of the document.

👤 Role of page author

  1. Read the page.

  2. Is the information still correct and relevant ?

    • Yes: Click the "Mark as Fresh" button on the banner. You have just "reset the clock" for this page!

    • No: Please edit the page to fix the outdated info, or leave a comment for the author.

What about pages that never change?

Some pages, like meeting notes or past policy records, don't need to be updated.

  • Action: Add the label freshpage-evergreen to the page.

  • Result: The page will stay Green forever.

NOTE

Keeping our documentation fresh helps everyone work faster. If you mark a page as fresh, your name will appear as the last person who verified it.