docs: add GitHub Pages setup guide and update site configuration

- Add comprehensive setup guide for enabling GitHub Pages
- Update _config.yml with correct GitHub username and repository URL
- Include step-by-step instructions for site deployment

Author: timkrebs

_config.yml

@@ -5,7 +5,7 @@ description: >-
   Get quick insights into your K8s environment with comprehensive analysis.
 
 baseurl: "/kdebug" # the subpath of your site, e.g. /blog
-url: "https://your-username.github.io" # the base hostname & protocol for your site
+url: "https://timkrebs.github.io" # the base hostname & protocol for your site
 
 # Build settings
 markdown: kramdown
@@ -55,7 +55,7 @@ features:
     icon: "🌐"
 
 # Social
-github_username: your-username
+github_username: timkrebs
 github_repo: kdebug
 
 # Exclude from processing

docs/github-pages-setup.md

@@ -0,0 +1,96 @@
+# 🚀 GitHub Pages Setup Guide for kdebug
+
+## Step 1: Enable GitHub Pages
+
+1. **Go to your repository**: https://github.com/timkrebs/kdebug
+2. **Click on "Settings"** (in the repository top navigation)
+3. **Scroll down to "Pages"** (in the left sidebar under "Code and automation")
+4. **Under "Source"**, select **"GitHub Actions"** (this enables the workflow we created)
+5. **Click "Save"**
+
+## Step 2: Wait for Deployment
+
+The GitHub Actions workflow will automatically:
+- Build the Jekyll site
+- Deploy it to GitHub Pages
+- Make it available at: **https://timkrebs.github.io/kdebug/**
+
+You can monitor the deployment progress in the "Actions" tab of your repository.
+
+## Step 3: Update Configuration (Optional)
+
+To customize the site for your repository, update `_config.yml`:
+
+```yaml
+# Update these values in _config.yml
+github_username: timkrebs
+github_repo: kdebug
+url: "https://timkrebs.github.io"
+```
+
+## Step 4: Verify Deployment
+
+Once the GitHub Actions workflow completes (usually 2-3 minutes), your website will be live at:
+
+**🌐 https://timkrebs.github.io/kdebug/**
+
+## What's Included
+
+Your website includes:
+
+### 📖 **Comprehensive Documentation**
+- **Getting Started** - Quick installation and usage guide
+- **Installation** - Detailed setup instructions for all platforms
+- **Commands Reference** - Complete command documentation with examples
+- **Examples** - Real-world troubleshooting scenarios
+- **Contributing** - Developer guide and contribution workflow
+
+### 🎨 **Professional Design**
+- **Kubernetes-inspired styling** - Professional blue color scheme
+- **Responsive design** - Works perfectly on mobile, tablet, and desktop
+- **Card-based layouts** - Clean, modern interface
+- **Fast loading** - Optimized for performance
+
+### 🔧 **Developer Features**
+- **Search engine optimization** - Great discoverability
+- **Mobile-first design** - Excellent mobile experience
+- **Accessible navigation** - Keyboard and screen reader friendly
+- **Live reload during development** - `make website-serve`
+
+## Development Workflow
+
+To work on the website locally:
+
+```bash
+# Install dependencies (one-time setup)
+make website-deps
+
+# Start development server
+make website-serve
+
+# Visit: http://localhost:4000
+```
+
+## Automatic Updates
+
+The website will automatically rebuild and deploy whenever you:
+- Push changes to the main branch
+- Update any website files (`_*`, `assets/`, `index.md`, etc.)
+
+## Next Steps
+
+1. **Enable GitHub Pages** using the steps above
+2. **Wait for deployment** (check Actions tab for progress)
+3. **Visit your live site**: https://timkrebs.github.io/kdebug/
+4. **Share with the community** - Your kdebug project now has professional documentation!
+
+## Support
+
+If you encounter any issues:
+- Check the GitHub Actions logs in the "Actions" tab
+- Review the website development guide in `docs/website.md`
+- Ensure Ruby and Jekyll are properly installed for local development
+
+---
+
+🎉 **Congratulations!** Your kdebug project now has a professional documentation website that will help users discover, install, and contribute to your project!