New Contributors Guide

Hello! Thank you for helping we really appreciate it! The infrastructure around large projects can be intimidating; for this repo here's what I had to learn to work smoothly:

Instructions for getting up and running with this repository

Opening a Project

Open VS by running .\startvs.cmd from a solution folder. This ensures that everything is configured correctly.

Writing Code

For small changes (typos, open bugs) just write and submit a PR. If there's a GitHub issue, please comment "hey I'm working on this". For anything but simple typos, code review takes multiple days and rounds of feedback. This is good and normal.

For larger changes, please open a conversation about what you want to build, and we will help you work through potential issues before you start coding.

(more details here)

(specific code patterns here)

If Unit Tests Won't Run

There's dlls locked by a zombie process. Use Task Manager (or Process Explorer) to find and kill it. Probably named "dotnet.exe".

If Stuff Is Generally Broken

Close VS, from the repo home re-run:

. .\activate.ps1
.\restore.cmd

If this doesn't work, first commit anything you want to keep, then

git clean -xdf -e .dotnet
. .\activate.ps1
.\build.cmd /t:Noop -norestore

If "Code Check" Has Failed on Your PR

Probably need to regen refs. Navigate to your solution directory and run

dotnet msbuild /t:GenerateReferenceSource