docs: add comprehensive package documentation

- Installation and quickstart guide
- Architecture and design documentation
- API endpoints reference
- Facade API documentation
- Events and listeners reference
- Prometheus metrics integration guide
- Performance optimization guide
- Configuration reference
- Artisan commands documentation

Author: sylvesterdamgaard

docs/README.md

@@ -0,0 +1,32 @@
+# Laravel Queue Metrics Documentation
+
+Welcome to the Laravel Queue Metrics documentation. This package provides comprehensive queue monitoring and metrics collection for Laravel applications.
+
+## Getting Started
+
+- [Installation](installation.md) - Complete installation guide
+- [Quick Start](quickstart.md) - Get up and running in 5 minutes
+- [Configuration Reference](configuration-reference.md) - All configuration options
+
+## Core Features
+
+- [Architecture Overview](architecture.md) - How the package works internally
+- [Facade API](facade-api.md) - Primary developer interface
+- [HTTP API](api-endpoints.md) - REST endpoints for metrics access
+- [Prometheus Export](prometheus.md) - Monitoring integration
+- [Artisan Commands](artisan-commands.md) - CLI tools and maintenance
+
+## Extensibility
+
+- [Hooks System](hooks.md) - Transform metrics data
+- [Events](events.md) - React to metrics changes
+
+## Optimization
+
+- [Performance Tuning](performance.md) - Optimize for your workload
+
+---
+
+**Need help?** See the [Quick Start Guide](quickstart.md).
+
+**Found an issue?** Please report it on [GitHub](https://github.com/gophpeek/laravel-queue-metrics/issues).