# Contributing

Thanks for your interest in improving **Windows Developer Config**! Contributions of every shape are welcome: bug reports, doc fixes, new workloads, and voice-and-tone tweaks.

- **Found a bug or a stale doc?** Open an issue: <https://github.com/microsoft/WindowsDeveloperConfig/issues>. Please include your Windows build (`winver`), the exact command you ran, and the failing output.
- **Adding or editing a flow / script?** All source lives under [`src/`](./src/). The top-level `windows-dev-config/`, `Workloads/`, and `wsl-comfort/` folders are Authenticode-signed release copies regenerated by the sign pipeline, so **don't edit them directly**. The full layout, the sign pipeline, the CI matrix, and the "how to add a language" walkthrough are in [`src/docs/development.md`](./src/docs/development.md).
- **Single source of truth for every flow** (paths, build/run commands, ids, language metadata) is [`src/manifest.yml`](./src/manifest.yml). The Command Palette extension, the CI harness, and the per-flow shims all read from it, so keep it in sync when adding or renaming a flow.
- **Code of conduct.** This project follows the [Microsoft Open Source Code of Conduct](./CODE_OF_CONDUCT.md).