Update container-environments.md (#1262)

Signed-off-by: Arham Mehta <[email protected]>
Co-authored-by: L.B. <[email protected]>

Author: arhamm1

docs/reference/infrastructure/container-environments.md

@@ -12,13 +12,46 @@ modality: "universal"
 
 # Container Environments
 
-This reference documents the default environments available in NeMo Curator containers and their configurations.
+Deploy NeMo Curator in containerized environments for reproducible, scalable data curation pipelines with pre-configured dependencies and optimized runtime settings.
 
-(reference-infrastructure-container-environments-main)=
+## Overview
 
-## Main Container Environment
+NeMo Curator provides official Docker containers with all dependencies pre-installed and optimized for production workloads. Containers offer:
 
-The primary NeMo Curator container includes a uv-managed virtual environment with all necessary dependencies.
+- **Reproducible Environments**: Consistent software stack across development, testing, and production
+- **Simplified Deployment**: No manual dependency installation or environment configuration
+- **GPU Acceleration**: Pre-configured CUDA, cuDNN, and NVIDIA libraries for optimal performance
+- **Multi-Modal Support**: Built-in support for text, image, video, and audio curation
+- **Cloud-Ready**: Compatible with Kubernetes, Docker Swarm, and cloud container orchestries
+
+**When to use containers:**
+- Production deployments requiring consistency and reliability
+- Multi-node cluster processing with identical environments
+- CI/CD pipelines for automated data curation workflows
+- Quick prototyping without local environment setup
+- GPU-accelerated processing in cloud environments
+
+## Available Containers
+
+### Main NeMo Curator Container
+
+The primary container includes comprehensive support for all curation modalities:
+
+**Container registry:** `nvcr.io/nvidia/nemo-curator:25.09`
+
+**Supported modalities:**
+- ✅ Text curation (CPU/GPU)
+- ✅ Image curation (GPU required)
+- ✅ Video curation (GPU required, FFmpeg included)
+- ✅ Audio curation (GPU required for ASR)
+
+**Pre-installed components:**
+- NeMo Curator with all optional dependencies (`[all]` extras)
+- CUDA 12.8.1 with cuDNN
+- Python 3.12 with uv package manager
+- FFmpeg 7+ with NVENC support (for video processing)
+- Ray, Dask, and distributed computing frameworks
+- NVIDIA optimized Python packages
 
 (reference-infrastructure-container-environments-curator)=