setup-task/CONTRIBUTING.md at 0dfd35e8743a7e853ef03e948cca7ec2d080bc6a

Files

per1234 4f37628acd Update Node.js version used for development and CI to 16

The test runner CI workflow was using Node.js 12.x, which reaches EOL 2022-04-30.

Other workflows did not specify a Node.js version, meaning they used whatever was installed on the GitHub Actions runner.

It will be best to define a specific version series for use and use that throughout the infrastructure and development.

2022-01-10 18:14:34 -08:00

2.3 KiB

Raw Blame History

Development workflow

1. Install Tools

Task

Common development processes are run using the Task task runner tool.

Follow the installation instructions here:
https://taskfile.dev/#/installation

Node.js

npm is used for dependency management.

Follow the installation instructions here:
https://nodejs.dev/download

Node.js 16.x is used for development of this project. nvm is recommended to easily switch between Node.js versions.

Extras

Some optional tools used by this project:

2. Coding

Now you're ready to work some TypeScript magic!

Make sure to write or update tests for your work when appropriate.

3. Format code

Format the code to follow the standard style for the project:

npm run format

4. Run tests

Run the tests to ensure that the code works as expected:

task check

5. Build

It is necessary to compile the code before it can be used by GitHub Actions. Remember to run this command before committing any code changes:

task build

6. Commit

Everything is now ready to make your contribution to the project, so commit it to the repository and submit a pull request.

Thanks!

Enable verbose logging for a pipeline

Additional log events with the prefix ::debug:: can be enabled by setting the secret ACTIONS_STEP_DEBUG to true.

See step-debug-logs for reference.

Release workflow

Instructions for releasing a new version of the action:

If the release will increment the major version, update the action refs in the examples in README.md (e.g., uses: arduino/setup-task@v1 -> uses: arduino/setup-task@v2).
Create a GitHub release, following the vX.Y.Z tag name convention. Make sure to follow the SemVer specification.
Rebase the release branch for that major version (e.g., v1 branch for the v1.x.x tags) on the tag. If no branch exists for the release's major version, create one.

2.3 KiB Raw Blame History