vscode-powershell icon indicating copy to clipboard operation
vscode-powershell copied to clipboard

[PSCore Align] Update contributing docs with top-level CONTRIBUTING.md

Open TylerLeonhardt opened this issue 7 years ago • 4 comments

To align with PowerShell Core's dev process/repo management.

TylerLeonhardt avatar Dec 19 '17 16:12 TylerLeonhardt

Is the plan to move this to a top-level CONTRIBUTING.md file? Maybe we need both? A top-level contributing guide (coding style, how to PR, expectations for a PR, etc) and a docs\development detailed guide on how to build the extension?

rkeithhill avatar Dec 19 '17 16:12 rkeithhill

@rkeithhill Yeah what you're describing is exactly what we want.

I like the idea of a CONTRIBUTING.md being the top-level contributing guide (coding style, how to PR, expectations for a PR, etc) and then that can link to how to build and test the extension.

TylerLeonhardt avatar Dec 19 '17 16:12 TylerLeonhardt

We should also have a link to the microsoft code of conduct like in the PowerShell repo in the README.md:

## [Code of Conduct][conduct-md]

This project has adopted the [Microsoft Open Source Code of Conduct][conduct-code].
For more information see the [Code of Conduct FAQ][conduct-FAQ] or contact [[email protected]][conduct-email] with any additional questions or comments.

[conduct-code]: http://opensource.microsoft.com/codeofconduct/
[conduct-FAQ]: http://opensource.microsoft.com/codeofconduct/faq/
[conduct-email]: mailto:[email protected]
[conduct-md]: https://github.com/PowerShell/PowerShell/tree/master/./CODE_OF_CONDUCT.md

TravisEz13 avatar Dec 20 '17 23:12 TravisEz13

I think coding style, and conduct for me would be secondary to how the solution hangs together, implementing a basic feature by example, what tests are run and from where (dotnet test or full visual studio) and actually building and debugging the project.

Benny1007 avatar Apr 08 '19 03:04 Benny1007