Updated New Contributors Guide (markdown)

Tanay Parikh 2022-11-30 14:42:06 -08:00
Родитель f0c92b5529
Коммит f068952772
1 изменённых файлов: 6 добавлений и 17 удалений

@ -1,17 +1,6 @@
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:
### Installation
```
git clone https://github.com/aspnet/AspNetCore.git
cd AspNetCore
git submodule update --init --recursive
. .\activate.ps1
.\restore.cmd
```
*([more details here](https://github.com/aspnet/AspNetCore/blob/master/docs/BuildFromSource.md))*
*(if restore fails complaining about Java JDK not being found, run `eng\scripts\InstallJdk.ps1`)*
[Instructions for getting up and running with this repository](https://github.com/dotnet/aspnetcore/blob/main/docs/BuildFromSource.md)
### Opening a Project
@ -23,9 +12,9 @@ For small changes (typos, open bugs) just write and submit a PR. If there's a Gi
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](https://github.com/aspnet/AspNetCore/blob/master/CONTRIBUTING.md))*
*([more details here](https://github.com/aspnet/AspNetCore/blob/main/CONTRIBUTING.md))*
*([specific code patterns here](https://github.com/aspnet/AspNetCore/wiki/Engineering-guidelines))*
*([specific code patterns here](https://github.com/dotnet/aspnetcore/wiki/Engineering-guidelines))*
### If Unit Tests Won't Run
@ -35,7 +24,7 @@ There's dlls locked by a zombie process. Use Task Manager (or Process Explorer)
Close VS, from the repo home re-run:
```
```bash
. .\activate.ps1
.\restore.cmd
```
@ -43,7 +32,7 @@ Close VS, from the repo home re-run:
If this doesn't work, first commit anything you want to keep, then
```
```bash
git clean -xdf -e .dotnet
. .\activate.ps1
.\build.cmd /t:Noop -norestore
@ -53,4 +42,4 @@ git clean -xdf -e .dotnet
Probably need to regen refs. Navigate to your solution directory and run
```dotnet msbuild /t:GenerateReferenceSource```
`dotnet msbuild /t:GenerateReferenceSource`