diff --git a/docs/ReferenceAssemblies.md b/docs/ReferenceAssemblies.md deleted file mode 100644 index 593682a29ecf..000000000000 --- a/docs/ReferenceAssemblies.md +++ /dev/null @@ -1,25 +0,0 @@ -Reference assemblies -======================== - -Most projects in this repo have a `ref` directory next to their `src` that contains the project and source code for a reference assembly. -Reference assemblies contain the public API surface of libraries and are used for ASP.NET Core targeting pack generation. - -### When changing public API - -Run `dotnet msbuild /t:GenerateReferenceSource` in that project's `src` directory - -### When adding a new project - -Run `.\eng\scripts\GenerateProjectList.ps1` from the repository root and `dotnet msbuild /t:GenerateReferenceSource` in that project's `src` directory - -### To set project properties in a reference assembly project - -`ref.csproj` is automaticaly generated and shouldn't be edited. To set project properties on a reference assembly project place a `Directory.Build.props` next to it and add the properties there. - -### My project doesn't need a reference assembly - -Set `false` in the implementation (`src`) project and re-run `.\eng\scripts\GenerateProjectList.ps1`. - -### Regenerate reference assemblies for all projects - -Run `.\eng\scripts\GenerateReferenceAssemblies.ps1` from repository root. Make sure you've run `.\restore.cmd` first.