diff --git a/js/leibovitz/contrast.js b/js/leibovitz/contrast.js
index 01312ad..b34f205 100644
--- a/js/leibovitz/contrast.js
+++ b/js/leibovitz/contrast.js
@@ -1,7 +1,28 @@
 /**
- * Contrast management module implementing contrast adjustment
- * Uses the Observer pattern for state management and effect application
- * Implements linear contrast adjustment algorithm
+ * @fileoverview Contrast management module implementing linear contrast adjustment.
+ * 
+ * @description
+ * Implements contrast adjustment using a linear scaling algorithm.
+ * Provides real-time contrast control with immediate visual feedback.
+ * 
+ * @architecture
+ * Implements the following design patterns:
+ * - Observer Pattern: For state management and effect application
+ * - Factory Pattern: For UI initialization
+ * - Strategy Pattern: For contrast adjustment algorithm
+ * - Command Pattern: For state reset operations
+ * 
+ * @algorithm
+ * Contrast adjustment process:
+ * 1. Calculate contrast factor using formula: (259 * (contrast + 255)) / (255 * (259 - contrast))
+ * 2. Apply linear scaling to each color channel
+ * 3. Maintain color balance while adjusting contrast
+ * 
+ * Features:
+ * - Linear contrast adjustment
+ * - Per-channel processing
+ * - Real-time updates
+ * - Preserves color relationships
  */
 
 const ContrastManager = {