mirror of
https://github.com/actions/setup-dotnet.git
synced 2024-11-23 03:51:07 +07:00
35 lines
1.6 KiB
Markdown
35 lines
1.6 KiB
Markdown
# Contributors
|
|
|
|
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.
|
|
|
|
If you would like to contribute there are a few things to consider:
|
|
|
|
## Commands to use
|
|
|
|
- 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)
|
|
|
|
## To check in or not to check in
|
|
|
|
- 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)
|
|
|
|
## 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.
|
|
|
|
## Creating new version
|
|
|
|
Details on versioning can be found here: https://github.com/actions/toolkit/blob/main/docs/action-versioning.md
|
|
Create a new release using the UI. Version format should be `v1.x.x`. Creating a new major version requires reaction from users and should be done only with breaking changes.
|
|
Once the new release is created, the v1 tag needs to be updated as well.
|
|
```
|
|
git tag -fa v1 -m "Update v1 tag"
|
|
git push origin v1 --force
|
|
```
|