[GitHub Discussions] WSL & Linux documentation gaps

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