diff --git a/docs/contributing/Roslyn-Debugging.md b/docs/contributing/Roslyn-Debugging.md index a3cd149246..e316428ac1 100644 --- a/docs/contributing/Roslyn-Debugging.md +++ b/docs/contributing/Roslyn-Debugging.md @@ -8,18 +8,24 @@ Sometimes it may be necessary to make changes in [`dotnet/roslyn`](https://githu 2. `./Restore.cmd` 3. Make the desired changes in `dotnet/roslyn`. 4. `./Build.cmd -pack`. The `-pack` option causes the creation of NuGet packages. -5. You should see the generated packages in the `\artifacts\packages\Debug\Debug` directory. Take note of the package versions (ie. `Microsoft.CodeAnalysis.Workspaces.Common.3.8.0-dev.nupkg` => `3.8.0-dev`). -6. Open `NuGet.config` and add the local package source `` and package source below under the `packageSourceMapping` tag: +5. You should see the generated packages in the `\artifacts\packages\Debug` directory. Take note of the package versions (ie. `Microsoft.CodeAnalysis.Workspaces.Common.3.8.0-dev.nupkg` => `3.8.0-dev`). +6. In the Razor repo, open `NuGet.config` and add two local package sources: + * `` + * `` +7. Add the package source mappings below under the `packageSourceMapping` tag: ```xml - + + + + - ``` -7. Open `eng/Versions.props` and update `RoslynPackageVersion` to the version noted in step 5. -8. To get the end-to-end local debugging working, running `./Build.cmd -deploy` script from roslyn repository. this will copy over the right binaries from roslyn to the shared local roslyn/razor hive. +7. Open `eng/Versions.props` and find the `MicrosoftCodeAnalysisExternalAccessRazorPackageVersion` property. +8. Grab the value of that property, and replace all instances of that value in the file to be the version noted in step 5. +9. To get the end-to-end local debugging working, running `./Build.cmd -deployExtensions` script from roslyn repository. this will copy over the right binaries from roslyn to the shared local roslyn/razor hive. ## Troubleshooting