Use Case Templates

Ready-to-use page templates demonstrating best-practice layouts with Content Formatting Macros. Each template includes a suggested macro layout, section structure, and guidance notes.

---

Template 1 - Team Hub Page

A comprehensive team home page that serves as the single entry point for all team information.

Page Structure

[Interactive Banner]
  Headline: [Team Name] Hub
  Subtitle: "Your starting point for everything [Team Name]"
  Background: Team color gradient
  CTA Button 1: "View Jira Board" → Jira URL
  CTA Button 2: "Team Calendar" → Confluence calendar page

[Divider - gradient style]

[Background: light gray]
  ## Quick Links
  [Buttons row: Jira Board | Confluence Space | Slack Channel | On-Call Rotation]

[Create Custom Tabs - Pill style]
  Tab 1: Overview
    [Alert - Info: Team description/charter]
    [Advanced Cards: 3-column grid of key processes with links]

  Tab 2: Team Members
    [User Profile (Card style) × N - one per team member]
    [Conditional Show: hr-managers group]
      [Table of roles and direct report lines]

  Tab 3: Processes
    [Tab Parent Content Mapper → "Processes" child page]

  Tab 4: Resources
    [Tab Label Content Mapper → label: team-resources]

  Tab 5: Announcements
    [Interactive Banner: latest announcement]
    [Advanced Expand: previous announcements (collapsed)]

[Divider]

[Background: white]
  ## Current Status
  [Status Macro: Sprint Status] [Status Macro: Deployment Status] [Status Macro: On-Call Status]
  [Progress Bar: Sprint completion %]
  [Countdown Timer: next sprint end / next release]

Key Macros

Interactive Banner, Buttons, Tab Parent Content Mapper, Tab Label Content Mapper, Create Custom Tabs, User Profile, Conditional Show, Advanced Cards, Alert, Status Macro, Progress Bar, Countdown Timer, Divider, Background, Advanced Expand

Guidance Notes

• Replace all placeholder content (team name, URLs, group names) before publishing
• Update the Status Macro values and Progress Bar value each sprint
• The Processes and Resources tabs auto-update as child pages and labeled pages are added - no ongoing maintenance needed
• Conditional Show section requires the hr-managers group to exist in Confluence Admin → Groups

---

Template 2 - IT Runbook

A standardized runbook template for IT operations. Apply this structure to every service runbook for consistent, scannable documentation.

Page Structure

[Alert - Warning]
  "Last reviewed: [Date] | Owner: [Team Name] | Status: [Status Macro]"

[Create Custom Tabs - Box style, Top position]
  Tab 1: Overview
    [Background: light blue]
      ## Service Overview
      [Table: Service Name | Owner | Tier | SLA | Repo | Monitoring Dashboard]
    [Buttons: Open Jira Board | Open Monitoring | Open Runbook Repository]
    [Alert - Info: Service description and purpose]

  Tab 2: Procedures
    ## Standard Procedures
    [Advanced Expand: "Deployment" (collapsed by default)]
      [Numbered steps for deployment procedure]
      [Alert - Warning: Pre-deployment checklist]
    [Advanced Expand: "Rollback" (collapsed by default)]
      [Background - red tint]
        [Alert - Error: Use only when deployment fails]
      [Numbered steps for rollback]
    [Advanced Expand: "Incident Response" (collapsed by default)]
      [Numbered steps]

  Tab 3: Escalation
    [Background: light gray]
      ## On-Call Contacts
      [User Profile (Standard style) × 3: L1, L2, L3]
    [Table: Escalation conditions and who to contact]
    [Conditional Show: confluence-admins group]
      [Alert - Note: Internal SLA notes and escalation override conditions]

  Tab 4: Architecture
    [Background: white]
      ## Architecture Overview
      [Confluence image or draw.io diagram]
    [Advanced Expand: "Dependencies" (expanded by default)]
      [Table: Dependency | Version | Owner | Health status]
    [JSON Viewer: Sample API response or config]

  Tab 5: Reference
    [Advanced Expand: "Accepted Values" (collapsed)]
      [Table of configuration values]
    [Advanced Expand: "Common Errors" (collapsed)]
      [Table: Error code | Meaning | Resolution]
    [Advanced Expand: "Useful Commands" (collapsed)]
      [Code blocks with common CLI commands]

Key Macros

Alert, Create Custom Tabs, Background, Buttons, Advanced Expand, User Profile, Conditional Show, JSON Viewer, Status Macro

Guidance Notes

• Set the Alert at the top to Warning type and update the review date when the runbook is reviewed
• The Escalation tab's Conditional Show should use the space admin or ops group - confirm the group name in Confluence Admin
• Keep the Procedures tab focused on step-by-step instructions; use the Reference tab for lookup tables
• Add a Status Macro badge to the top Alert to show current service health at a glance

---

Template 3 - Project Status Page

A living project status page that gives stakeholders a real-time view of project health, timeline, and deliverables.

Page Structure

[Interactive Banner]
  Headline: [Project Name]
  Subtitle: [One-line project goal]
  Background: Project color
  CTA Button 1: "View Jira Project" → Jira project URL
  CTA Button 2: "Project Charter" → Charter page URL

[Background: light gray]
  ## At a Glance
  [Status Macro: Overall Status] [Status Macro: Budget Status] [Status Macro: Timeline Status] [Status Macro: Risk Status]
  [Progress Bar: % complete, label: "Project Completion"]
  [Countdown Timer: "Go-Live in" → target delivery date]

[Create Custom Tabs - Underline style]
  Tab 1: Summary
    [Alert - appropriate type based on current status]
    [Table: Milestone | Target Date | Status (Status Macro) | Owner]
    [Advanced Cards: 3 cards - Scope | Timeline | Budget summaries]

  Tab 2: Workstreams
    [Tab Parent Content Mapper → "Workstreams" child page]
    (Each workstream is a child page with its own status/progress)

  Tab 3: Risks & Issues
    [Table: Risk/Issue | Severity (Status Macro) | Owner | Mitigation | Status]
    [Alert - Warning: Any open blockers]

  Tab 4: Decisions Log
    [Table: Date | Decision | Made By | Rationale | Link]

  Tab 5: Stakeholders
    [User Profile (Standard style): Sponsor, PM, Tech Lead, Business Owner]
    [Conditional Show: project-leads group]
      [Table: Stakeholder engagement plan - internal use only]

  Tab 6: Documents
    [Advanced Cards: links to Charter, SOW, Architecture Doc, Test Plan, Retrospective]

Key Macros

Interactive Banner, Buttons, Background, Status Macro, Progress Bar, Countdown Timer, Alert, Tab Parent Content Mapper, Create Custom Tabs, Advanced Cards, User Profile, Conditional Show

Guidance Notes

• Update the Status Macro badges and Progress Bar at the start of each status reporting cycle (weekly or sprint-by-sprint)
• The Countdown Timer creates urgency - update the target date if the go-live date changes
• The Workstreams tab auto-updates as workstream child pages are added - structure child pages consistently (use this same template for each workstream page)
• The Conditional Show on the Stakeholders tab uses a project-leads group - create this group in Confluence Admin and add the appropriate members