setup-dotnet/docs/contributors.md

25 lines
1.2 KiB
Markdown
Raw Normal View History

2019-06-19 20:22:22 +00:00
# Contributors
2020-07-16 15:20:11 +00:00
Thank you for contributing! This action is targetted around setting up the dotnet cli and related sdks for GitHub actions. As part of that we use proxy settings (for self-hosted runners) and set-up nuget authentication for private feeds.
2019-06-19 20:22:22 +00:00
2020-07-16 15:20:11 +00:00
If you would like to contribute there are a few things to consider:
2019-06-19 20:22:22 +00:00
2020-07-16 15:20:11 +00:00
## Commands to use
2019-06-19 20:22:22 +00:00
2020-07-16 15:20:11 +00:00
- npm run build - Compiles the action into a single js file at dist/index.js (Please check in the changes made by this command)
- npm run test - Runs all tests under __tests__
- npm run format - Runs formatting required to pass the lint test (Please check in the changes made by this command)
- npm run update-installers - Updates the install-dotnet scripts in externals (Please check in the changes made by this command)
2019-06-19 20:22:22 +00:00
2020-07-16 15:20:11 +00:00
## To check in or not to check in
2019-06-19 20:22:22 +00:00
2020-07-16 15:20:11 +00:00
- Do check in source (src)
- Do check in index file (dist)
- Do check in updates to install-dotnet scripts (externals)
- Do not check in build output (lib)
- Do not check in runtime (node_modules)
2019-06-19 20:22:22 +00:00
2020-07-16 15:20:11 +00:00
## Writing tests
With any contribution please take time to consider how this can be tested to maintain high quality. Current tests can be found in the folder __tests__ for examples.