docs: add comprehensive user quickstart guides

Add user-focused documentation including quickstart guides,
installation instructions, configuration options, and troubleshooting.

- Add user documentation directory with comprehensive guides
- Add developer getting started guide with Docker Compose setup
- Restructure docs with consistent README.md naming
- Add detailed installation guide for multiple deployment methods
- Add quickstart guide with 4 different setup approaches
- Add comprehensive troubleshooting guide for common issues
- Add configuration guide covering all Kepler settings

The documentation provides clear paths for different user types from
beginners to advanced users, with practical examples and step-by-step
instructions for deploying and configuring Kepler.

Signed-off-by: Sunil Thaha <[email protected]>

Author: sthaha

README.md

@@ -54,33 +54,44 @@ accurate energy consumption monitoring for cloud-native workloads.
 
 ## 🚀 Getting Started
 
-> **📖 For comprehensive installation instructions, troubleshooting, and advanced deployment options, see our [Installation Guide](docs/user/installation.md)**
+**New to Kepler?** Follow our [**📖 Getting Started Guide**](docs/user/getting-started.md) for quick Kubernetes cluster deployment, or see our [**🧑‍💻 Developer Getting Started Guide**](docs/developer/getting-started.md) for local development with dashboards.
 
 ### ⚡ Quick Start
 
 Choose your preferred method:
 
 ```bash
-# 💻 Local Development
-make build && sudo ./bin/kepler
+# 🎯 Deploy to Kubernetes Cluster (Recommended for users)
+helm install kepler manifests/helm/kepler/ --namespace kepler --create-namespace
 
-# ✨ Docker Compose (with Prometheus & Grafana)
-cd compose/dev && docker-compose up -d
+# 🧑‍💻 Local Development with Dashboards
+cd compose/dev && docker compose up -d
+# Access Grafana: http://localhost:23000 (admin/admin)
 
-# 🐳 Kubernetes
-helm install kepler manifests/helm/kepler/ --namespace kepler --create-namespace
+# 🏗️ Local Kubernetes Development
+make cluster-up && make deploy
+
+# 💻 Build from Source
+make build && sudo ./bin/kepler
 ```
 
+> **📖 For detailed installation instructions, troubleshooting, and advanced deployment options, see our [Installation Guide](docs/user/installation.md)**
+
 ## 📖 Documentation
 
 ### User Documentation
 
-- **[Installation Guide](docs/user/installation.md)** - Detailed installation instructions for all deployment methods
-- **[Configuration Guide](docs/user/configuration.md)** - Configuration options and examples
+📋 **[User Guide Index](docs/user/README.md)** - Complete navigation hub for all user documentation
+
+- **[Getting Started Guide](docs/user/getting-started.md)** - Quick Kubernetes cluster deployment
+- **[Installation Guide](docs/user/installation.md)** - Production deployment methods and enterprise integration
+- **[Configuration Guide](docs/user/configuration.md)** - Configuration options and customization examples
+- **[Troubleshooting Guide](docs/user/troubleshooting.md)** - Comprehensive problem-solving and debugging guide
 - **[Metrics Documentation](docs/user/metrics.md)** - Available metrics and their descriptions
 
 ### Developer Documentation
 
+- **[Developer Getting Started Guide](docs/developer/getting-started.md)** - Local development setup with Docker Compose, dashboards, and building from source
 - **[Architecture Documentation](docs/developer/design/architecture/)** - Complete architectural documentation including design principles, system components, data flow, concurrency model, and deployment patterns
 - **[Power Attribution Guide](docs/developer/power-attribution-guide.md)** - How Kepler measures and attributes power consumption
 - **[Developer Documentation](docs/developer/)** - Contributing guidelines and development workflow

docs/index.md renamed to docs/README.md

@@ -8,6 +8,7 @@ Welcome to the Kepler documentation. Kepler is a Prometheus exporter that measur
 
 Documentation for users deploying and operating Kepler:
 
+- [Getting Started Guide](user/getting-started.md) - Quick Kubernetes cluster deployment
 - [Installation Guide](user/installation.md) - How to install and deploy Kepler
 - [Configuration Guide](user/configuration.md) - Configuring Kepler for your environment
 - [Metrics Reference](user/metrics.md) - Available Prometheus metrics exported by Kepler
@@ -22,7 +23,7 @@ Documentation for developers contributing to Kepler:
 
 ## Quick Start
 
-For a quick start, see the [Installation Guide](user/installation.md) and the main project README.
+For a quick start, see the [Getting Started Guide](user/getting-started.md) and the main project README.
 
 ## Contributing
 

docs/developer/index.md renamed to docs/developer/README.md

@@ -24,6 +24,7 @@ This section contains documentation for developers working on Kepler.
 
 ## Development Workflow
 
+- [Developer Getting Started](getting-started.md) - Building from source and setting up development environments
 - [Pre-commit Setup](pre-commit.md) - Setting up pre-commit hooks for code quality
 
 ## Release Management

docs/developer/design/architecture/index.md renamed to docs/developer/design/architecture/README.md

@@ -84,7 +84,7 @@ For specific implementation work:
 ## Related Documentation
 
 - **[Power Attribution Guide](../../power-attribution-guide.md)**: Detailed explanation of power calculation methodology
-- **[Development Setup](../../index.md)**: Setting up the development environment
+- **[Development Setup](../../README.md)**: Setting up the development environment
 - **[User Configuration Guide](../../../user/configuration.md)**: End-user configuration options
 
 ---