<!--
title: Concise performance documentation
domain: data-systems
topic: Performance Optimization
language: Other
source: supabase/supabase
updated: 2025-03-26
url: https://awesomereviewers.com/reviewers/supabase-concise-performance-documentation/
-->

When documenting performance metrics, benchmarks, or scalability information, prioritize clarity and conciseness. Avoid redundant wording, use consistent terminology when listing features, and structure information in a scannable format. Clear performance documentation helps developers understand system capabilities, set appropriate expectations, and make informed optimization decisions.

Example:
```diff
- The proposed workloads are designed to demonstrate Supabase Realtime's throughput and scalability capabilities. These benchmarks focus on core functionality and common usage patterns.
+ The proposed workloads are designed to demonstrate Supabase Realtime's throughput and scalability. These benchmarks focus on core functionality and common usage patterns.

- This guide explores the scalability of Realtime's features: Broadcast, Presence performance, and Postgres Changes.
+ This guide explores the scalability of Realtime's features: Broadcast, Presence, and Postgres Changes.
```

Clear performance documentation is critical for performance optimization efforts as it establishes baseline expectations and provides the context needed for future optimizations.
