Add comprehensive user documentation for Pengwin and pengwin-setup

[Copilot]

Create comprehensive Pengwin User Guide with focus on pengwin-setup

• [x] Create main USER_GUIDE.md with the following sections:
  • [x] Introduction to Pengwin
  • [x] Initial Setup (Installing WSL, Installing Pengwin, First Launch)
  • [x] Quick Start Guide (pengwin-setup basics, navigation, automated mode)
  • [x] Configuration and Settings (GUI, systemd, Home Backups, winhome, etc.)
  • [x] Detailed Options Reference (AI, Editors, GUI, Maintenance, Programming, Services, Settings, Tools, Uninstall)
  • [x] Troubleshooting
  • [x] Additional Resources
• [x] Create README.md to introduce the project and reference the user guide
• [x] Address review feedback:
  • [x] Standardize systemd capitalization
  • [x] Update website links to whitewaterfoundry.com
  • [x] Clarify Pengwin is Microsoft Store only
  • [x] Update WSL install command
  • [x] Remove auto-launch mention
  • [x] Fix issues link
  • [x] Document Windows fonts integration feature (unique to Pengwin)
  • [x] Review pengwin-base repository and enhance documentation with additional features

Documentation deliverables:

• USER_GUIDE.md (1,650+ lines): Comprehensive guide covering all aspects of Pengwin and pengwin-setup
• README.md (165+ lines): Project overview, quick start, and navigation to detailed guide

Key Features Documented

Pengwin-Specific Features

• Debian 13 (Trixie) foundation - Clear identification of base distribution
• Windows fonts integration - Linux GUI applications can directly use Windows fonts without configuration
• GPU acceleration - Direct3D 12 for graphics with VDPAU and VA-API for video acceleration
• Built-in aliases - Pre-configured shortcuts: winget, wsl, ll commands
• Helper tools - pengwin-help, switch2dev, switch2next commands

systemd Implementation

• Custom start-systemd script for WSL2 with full systemd support
• wslsystemctl and wsljournalctl for WSL1 compatibility
• Automatic WSL version detection and configuration

Windows Integration

• Seamless file access via winhome symbolic link
• Explorer context menu integration
• Start menu shortcuts
• Windows Terminal configuration

Both files are complete and updated based on comprehensive review of pengwin-setup and pengwin-base repositories.

Original prompt

I think you have now enough information to craft a user guide for pengwin, focusing on pengwin-setup. it can have sections like, initial setup, like installing the distro, create the user, etc, like any other wsl distro, then a quickstart, explaining the basics of pengwin-setup, like the updates, settings, enabling disabling, systemd, home backups, use of the winhome link to access windows home, gui configuration, desktop installation. Then a detailed section which will explain each of the pengwin-setup options, at the end a troubleshooting section. YOu can suggest other sections or content and can make me questions

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.