Skip to main content

Documentation Site Redesign and Content Updates

· 3 min read
Marius Nergård
Marius Nergård
Product owner Breeze @ Sotera

Documentation Site Redesign - November 7, 2025​

This update introduces a comprehensive redesign of the documentation homepage and significant improvements to key documentation pages, making it easier for users to discover and navigate Breeze documentation.

Homepage Redesign​

Visual Improvements:

  • Complete redesign of the documentation homepage with modern, user-focused layout
  • Added Breeze logo with automatic theme switching (light/dark mode support)
  • Enhanced hero section with gradient backgrounds and improved typography
  • Redesigned call-to-action buttons with better visual hierarchy

New Homepage Features:

  • Quick Links Section: Added prominent quick links to major documentation sections including Getting Started, Authentication, Credential Management, Tenant Management, Integrations, and Release Logs
  • Value Propositions Section: Added feature cards highlighting key Breeze capabilities:
    • Physical & Mobile Credentials management
    • Multi-Tenant Architecture
    • Automated System Integration
    • Enterprise SSO & User Onboarding
  • Improved responsive design for mobile and tablet devices
  • Enhanced accessibility with proper ARIA labels and focus states

Technical Updates:

  • Refactored homepage component structure for better maintainability
  • Added comprehensive CSS styling with theme-aware color schemes
  • Implemented smooth hover effects and transitions
  • Optimized layout for better performance and readability

Content Updates​

Introduction Page (docs/intro.mdx):

  • Completely rewritten introduction with clearer value proposition
  • Added "What You Can Do with Breeze" section with direct links to key features
  • Added comprehensive "Documentation Sections" overview
  • Included note about documentation being continuously updated
  • Improved description of Breeze as an Identity and Access Management (IAM) platform

Tenant Administration Overview (docs/tenant-administration/index.md):

  • Expanded overview with detailed explanation of Tenant concept
  • Added "Tenant Administration Features" section covering:
    • Production Sites functionality and key features
    • Tenant Settings configuration options
  • Added "Getting Started" section with links to detailed guides
  • Added "Common Tasks" section for quick reference
  • Improved structure and formatting for better readability

New Documentation Sections:

  • Authentication Overview (docs/authentication/index.mdx): New overview page covering:

    • Authentication concepts and benefits
    • Single Sign-On (SSO) features and availability
    • Getting started guides and common tasks
    • Links to detailed SSO documentation

  • Integrations Overview (docs/integrations/index.mdx): New overview page covering:

    • Integration concepts and benefits
    • Access Management Router (AMR) features and use cases
    • Getting started guides and common tasks
    • Links to detailed AMR documentation

User Experience Improvements​

  • More intuitive navigation with clear visual hierarchy
  • Better content organization with logical grouping
  • Enhanced discoverability of key features and documentation sections
  • Improved mobile responsiveness across all updated pages
  • Consistent styling and formatting throughout

Technical Improvements​

  • Updated CSS with modern styling techniques
  • Improved theme support for light and dark modes
  • Better component structure and code organization
  • Enhanced accessibility features