setup-dotnet/docs/contributors.md
Vladimir Safonkin 53d632b5c0
Update docs to v2 (#278)
* Update docs to v2

* Bump checkout action to v3

* Update installer scripts

* Replace v2 to vX on the docs, minor fixes

* Remove extra whitespace
2022-04-01 09:48:47 -04:00

1.7 KiB

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 vX.Y.Z. Creating a new major version requires reaction from users and should be done only with breaking changes. Once the new release is created, the vX tag needs to be updated as well.

git tag -fa vX -m "Update vX tag"
git push origin vX --force

For example, if you're publishing v2:

git tag -fa v2 -m "Update v2 tag"
git push origin v2 --force