[GitHub Discussions] WSL & Linux documentation gaps

@IEvangelist is already working on this.

Since Jun 2, 2026.

## Summary

Based on analysis of 820 GitHub discussions from dotnet/aspire.

**Question counts:**
| Topic | Questions |
|-------|-----------|
| WSL/Linux | 18 |
| WSL Mixed Development | 6+ |
| Linux-only | 5+ |
| macOS | 5+ |

---

## Gaps Identified

### 1. ❌ WSL Mixed Development (No docs)

**Discussions:**
- https://github.com/dotnet/aspire/discussions/13453: How to start aspire in WSL?
- https://github.com/dotnet/aspire/discussions/13429: How to run aspire python in wsl while aspnet in windows

**Customer Questions:**
- Running Aspire in WSL
- Mixed WSL/Windows development
- Python in WSL + .NET on Windows

**Action Items:**
- [ ] WSL development guide
- [ ] Mixed platform patterns (WSL + Windows)
- [ ] Cross-platform debugging

---

### 2. ❌ Linux Development

**Discussions:**
- https://github.com/dotnet/aspire/discussions/12561: Allow running and debugging a Linux-only project on aspire
- https://github.com/dotnet/aspire/discussions/1381: Problem with running .net aspire project on linux
- https://github.com/dotnet/aspire/discussions/5859: Error with npm on ubuntu: executable file not found in ``

**Customer Questions:**
- Linux-only project debugging
- npm path issues on Linux
- General Linux troubleshooting

**Action Items:**
- [ ] Linux setup guide
- [ ] Linux troubleshooting
- [ ] npm/Node.js on Linux

---

### 3. ⚠️ macOS Issues

**Discussions:**
- https://github.com/dotnet/aspire/discussions/8375: Azure Functions does not start via AddAzureFunctionsProject on macOS

**Customer Questions:**
- macOS-specific issues
- Azure Functions on macOS

**Action Items:**
- [ ] macOS troubleshooting
- [ ] Platform-specific limitations

---

## Data Source

- **GitHub Discussions:** 820 total
- **WSL/Linux-related:** 18 discussions
- **Date range:** Project inception - February 2026