Docs: combine features and usage into single page, reorder cache options lower in usage

Author: Matars

docs/configuration.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Configuration
-nav_order: 5
+nav_order: 4
 ---
 
 # Configuration

docs/contributors.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Contributors & Acknowledgements
-nav_order: 8
+nav_order: 7
 ---
 
 # Contributors & Acknowledgements

docs/development.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Development
-nav_order: 7
+nav_order: 6
 ---
 
 # Development

docs/features.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Supported Providers
-nav_order: 6
+nav_order: 5
 ---
 
 # Supported Providers

docs/providers.md

@@ -1,10 +1,42 @@
 ---
 layout: default
-title: Usage
-nav_order: 4
+title: Features & Usage
+nav_order: 2
 ---
 
-# Usage
+# Features & Usage
+
+gitfetch brings the magic of neofetch to your git hosting platforms, displaying your coding activity in a stunning, colorful terminal interface that's both beautiful and highly customizable.
+
+## 🚀 Core Features
+
+- **Neofetch-style display** with stunning ASCII art that brings your stats to life
+- **Comprehensive statistics** from GitHub, GitLab, Gitea, Forgejo, Codeberg, and Sourcehut
+- **Smart SQLite-based caching** system for lightning-fast subsequent runs
+- **Cross-platform support** (macOS and Linux) - works wherever you code
+- **View active pull requests and issues** - stay on top of your contributions
+- **Display commit streak information** - track your coding momentum
+- **Extensive customization** options that let you make it truly yours
+
+## 🎨 Visual Customization
+
+Transform your gitfetch display with powerful visual options:
+
+- **Custom contribution characters** - use any symbol or emoji for your graph blocks
+- **Dynamic section control** - hide/show achievements, languages, issues, PRs, and more
+- **Flexible dimensions** - adjust width and height to fit your terminal perfectly
+- **ASCII art simulation** - create pixel art from text or use predefined shapes like kitty, cat, heart, and star
+- **Advanced color customization** with hex codes and predefined color schemes
+
+## 🧠 Intelligent Layout System
+
+gitfetch automatically adapts to your terminal environment:
+
+- **Full Layout**: Complete information display when you have 120+ columns
+- **Compact Layout**: Side-by-side graph and stats for medium terminals
+- **Minimal Layout**: Clean contribution graph for narrow screens
+
+The system intelligently considers both terminal width AND height to deliver the optimal viewing experience, no matter your setup.
 
 ## Basic Usage
 
@@ -43,20 +75,6 @@ Displays git commit timeline, built from local git history
 - No language statistics for the repository
 - Limited to local git history analysis
 
-## Cache Options
-
-Bypass cache and fetch fresh data:
-
-```bash
-gitfetch username --no-cache
-```
-
-Clear cache:
-
-```bash
-gitfetch --clear-cache
-```
-
 ## Configuration
 
 Change the configured git provider:
@@ -116,6 +134,20 @@ gitfetch --no-grid             # Hide contribution grid
 gitfetch --no-date --no-achievements --custom-box "█" --width 60
 ```
 
+## Cache Options
+
+Bypass cache and fetch fresh data:
+
+```bash
+gitfetch username --no-cache
+```
+
+Clear cache:
+
+```bash
+gitfetch --clear-cache
+```
+
 ## Layout Control
 
 gitfetch automatically adapts to your terminal size, but you can control spacing: