Build system documentation and IDE integration

[halcwb]

Issue Description

Document the build system architecture and how different components interact.

Missing Documentation

@draptick identified several areas that need clarification:

Build System Questions

• How does dotnet run interact with FAKE build system?
• How does the build server (GitHub Actions) work?
• How does the build work when invoked from Rider/VSCode?
• Can the application be started from Rider in debug mode?

Suggested Solution

Create comprehensive build system documentation covering:

1. Local development workflow
2. IDE integration (Rider, VSCode)
3. FAKE build targets and their purposes
4. CI/CD pipeline explanation
5. Debug mode setup for different IDEs

Related

Part of onboarding feedback from @draptick