Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions workflow-templates/check-action-metadata-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,17 +76,17 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
```text
Add CI workflow to validate action.yml

A task and GitHub Actions workflow are provided here for validating the action.yml metadata file of GitHub Actions
actions.
A task and GitHub Actions workflow are provided here to check for problems in the `action.yml` metadata file of GitHub Actions actions by validating it against the JSON schema.

On every push or pull request that affects the metadata file, and periodically, validate action.yml against its JSON
schema.
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
A task and GitHub Actions workflow are provided here for validating the [`action.yml`](https://docs.github.com/actions/creating-actions/metadata-syntax-for-github-actions) metadata file of [GitHub Actions actions](https://docs.github.com/actions/learn-github-actions/understanding-github-actions#actions).
A task and GitHub Actions workflow are provided here to check for problems in the [`action.yml`](https://docs.github.com/actions/creating-actions/metadata-syntax-for-github-actions) metadata file of [GitHub Actions actions](https://docs.github.com/actions/learn-github-actions/understanding-github-actions#actions) by validating it against [the JSON schema](https://json.schemastore.org/github-action.json).

On every push or pull request that affects the metadata file, and periodically, validate `action.yml` against [its JSON schema](https://json.schemastore.org/github-action.json).
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
8 changes: 4 additions & 4 deletions workflow-templates/check-files-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,9 +61,9 @@ Tasks are also added to check for problems with symbolic links ("symlinks") cont
- Broken symlinks
- Circular symlinks

A GitHub Actions workflow is included to run the tasks on any change to the project files in order to avoid the
introduction of problems with the project filesystem, and periodically in order to catch breakage caused by external
changes.
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message
Expand All @@ -81,5 +81,5 @@ Tasks are also added to check for problems with symbolic links ("symlinks") cont
- Broken symlinks
- Circular symlinks

A GitHub Actions workflow is included to run the tasks on any change to the project files in order to avoid the introduction of problems with the project filesystem, and periodically in order to catch breakage caused by external changes.
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
17 changes: 13 additions & 4 deletions workflow-templates/check-general-formatting-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,14 +49,23 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
## Commit message

```
Add CI workflow to check general file formatting
Add infrastructure for checking general file formatting

On every push, pull request, and periodically, check whether the repository's files are formatted according to
.editorconfig.
The project's .editorconfig file defines the fundamental formatting style for use in the project files.

A task is added to use the "editorconfig-checker" tool to verify the formatting of the project files is compliant.

A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
On every push, pull request, and periodically, use [editorconfig-checker](https://github.com/editorconfig-checker/editorconfig-checker) check whether the repository's files are formatted according to [`.editorconfig`](https://editorconfig.org/).
The project's [`.editorconfig`](https://editorconfig.org/) file defines the fundamental formatting style for use in the project files.

A task is added to use the [**editorconfig-checker**](https://github.com/editorconfig-checker/editorconfig-checker) tool to verify the formatting of the project files is compliant.

A GitHub Actions workflow is included to automatically run the task. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
6 changes: 3 additions & 3 deletions workflow-templates/check-go-dependencies-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,11 +112,11 @@ An updated cache is also generated whenever the cache is found to be outdated by
## Commit message

```
Add CI workflow to check for unapproved Go dependency licenses
Add infrastructure to check for unapproved Go dependency licenses

A task and GitHub Actions workflow are provided here for checking the license types of Go project dependencies.
Tasks and a GitHub Actions workflow are added for checking the license types of Go project dependencies.

On every push and pull request that affects relevant files, the CI workflow will check:
On every push and pull request that affects relevant files, the CI workflow will run the tasks to check:

- If the dependency licenses cache is up to date
- If any of the project's dependencies have an unapproved license type.
Expand Down
4 changes: 2 additions & 2 deletions workflow-templates/check-go-dependencies-task.yml
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ jobs:
with:
submodules: recursive

# This is required to allow licensee/setup-licensed to install licensed via Ruby gem.
# This is required to allow licensee/setup-licensed to install Licensed via Ruby gem.
- name: Install Ruby
uses: ruby/setup-ruby@v1
with:
Expand Down Expand Up @@ -135,7 +135,7 @@ jobs:
with:
submodules: recursive

# This is required to allow licensee/setup-licensed to install licensed via Ruby gem.
# This is required to allow licensee/setup-licensed to install Licensed via Ruby gem.
- name: Install Ruby
uses: ruby/setup-ruby@v1
with:
Expand Down
22 changes: 8 additions & 14 deletions workflow-templates/check-go-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Install the [`check-go-task.yml`](check-go-task.yml) GitHub Actions workflow to
- Install to: repository root (or merge into the existing `Taskfile.yml`).
- [`.golangci.yml`](assets/go/.golangci.yml) - Contains all the go-linting configurations.
- Install to: repository root as `.golangci.yml`
- [`Taskfile.yml`](assets/go-task/Taskfile.yml) - `DEFAULT_GO_MODULE_PATH` and `DEFAULT_GO_PACKAGES` variables
- [`Taskfile.yml`](assets/go-task/Taskfile.yml) - `DEFAULT_GO_MODULE_PATH` and `DEFAULT_GO_PACKAGES` variables.
- Merge into `Taskfile.yml`

### Configuration
Expand Down Expand Up @@ -50,25 +50,19 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
## Commit message

```
Add CI workflow to lint and check formatting of Go code
Add infrastructure to lint and format Go code

On every push and pull request that affects relevant files, check the Go module for:
Tasks are provided to format and check for problems in the project's Go modules.

- Common detectable errors in the code.
- Use of outdated APIs
- Code style violations
- Code formatting inconsistency
- Misconfiguration
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
On every push and pull request that affects relevant files, check the repository's [Go](https://golang.org/) module for:
Tasks are provided to format and check for problems in the project's [Go](https://golang.org/) modules.

- Common detectable errors in the code.
- Use of outdated APIs
- Code style violations
- Code formatting inconsistency
- Misconfiguration
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
17 changes: 9 additions & 8 deletions workflow-templates/check-javascript-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,20 +80,21 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
## Commit message

```
Add CI workflow to lint JavaScript code
Add infrastructure to lint JavaScript code

On every push and pull request that affects relevant files, and periodically, run ESLint on the repository's JavaScript
files.
A task is provided to run ESLint on the project's JavaScript files.

ESLint is configured via the .eslintrc.yml file:
https://eslint.org/docs/latest/use/configure/configuration-files
A GitHub Actions workflow is included to automatically run the task. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
On every push and pull request that affects relevant files, and periodically, run [**ESLint**](https://eslint.org/) on the repository's JavaScript files.
A task is provided to run [**ESLint**](https://eslint.org/) on the project's JavaScript files.

**ESLint** is configured via the `.eslintrc.yml` file:
https://eslint.org/docs/latest/use/configure/configuration-files
A GitHub Actions workflow is included to automatically run the task. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```
29 changes: 9 additions & 20 deletions workflow-templates/check-markdown-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,38 +99,27 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
## Commit message

```
Add CI workflow to check Markdown files for problems
Add infrastructure to check for problems in Markdown files

On every push and pull request that affects relevant files, and periodically, check the repository's Markdown files for
problems:
Tasks are provided to check for problems in the project's Markdown files:

- Use markdownlint to check for common problems and formatting.
- Use markdown-link-check to check for broken links.

The Arduino tooling Markdown style is defined by the `.markdownlint.yml` file.

In the event the repository contains externally maintained Markdown files, markdownlint can be configured to ignore them
via a `.markdownlintignore` file:
https://github.com/igorshubovych/markdownlint-cli#ignoring-files

markdown-link-check is configured via the `.markdown-link-check.json` file:
https://github.com/tcort/markdown-link-check#config-file-format
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
On every push and pull request that affects relevant files, and periodically, check the repository's Markdown files for
problems:
Add infrastructure to check for problems in Markdown files

Tasks are provided to check for problems in the project's Markdown files:

- Use [markdownlint-cli](https://github.com/igorshubovych/markdownlint-cli) to check for common problems and formatting.
- Use [markdown-link-check](https://github.com/tcort/markdown-link-check) to check for broken links.

The Arduino tooling Markdown style is defined by the `.markdownlint.yml` file.

In the event the repository contains externally maintained Markdown files, markdownlint can be configured to ignore them via a `.markdownlintignore` file:
https://github.com/igorshubovych/markdownlint-cli#ignoring-files

markdown-link-check is configured via the `.markdown-link-check.json` file:
https://github.com/tcort/markdown-link-check#config-file-format
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
16 changes: 11 additions & 5 deletions workflow-templates/check-npm-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,19 +63,25 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
## Commit message

```
Add CI workflow to check for problems with npm configuration files
Add infrastructure to check for problems with npm configuration files

On every push and pull request that affects relevant files, and periodically:
Tasks are provided to check for problems in the project's npm configuration files:

- Validate package.json against its JSON schema.
- Check for forgotten package-lock.json syncs.
* Validate package.json against its JSON schema.
* Check for forgotten package-lock.json syncs.

A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
On every push and pull request that affects relevant files, and periodically:
Tasks are provided to check for problems in the project's npm configuration files:

- Validate [`package.json`](https://docs.npmjs.com/cli/v7/configuring-npm/package-json) against [its JSON schema](https://json.schemastore.org/package.json).
- Check for forgotten [`package-lock.json`](https://docs.npmjs.com/cli/v7/configuring-npm/package-lock-json) syncs.

A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
7 changes: 4 additions & 3 deletions workflow-templates/check-poetry-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,8 +52,9 @@ The tasks provide the following operations:
* Update the `poetry.lock` file as may be required following manual modifications to `pyproject.toml`, or update of the
"Poetry" application

These tasks are executed by the GitHub Actions workflow on any push or pull request that modifies relevant files, and
periodically to check for breakage caused by external changes.
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message
Expand All @@ -68,5 +69,5 @@ The tasks provide the following operations:
- Check for problems with the data structure of the [`pyproject.toml`](https://python-poetry.org/docs/pyproject/) Python project file
- Update the `poetry.lock` file as may be required following manual modifications to `pyproject.toml`, or update of the **Poetry** application

These tasks are executed by the GitHub Actions workflow on any push or pull request that modifies relevant files, and periodically to check for breakage caused by external changes.
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
13 changes: 9 additions & 4 deletions workflow-templates/check-prettier-formatting-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,14 +115,19 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
## Commit message

```
Add CI workflow to check for Prettier formatting compliance
Add infrastructure for code formatting via Prettier

On every push and pull request that affects relevant files, check whether the formatting of supported
files is compliant with the Prettier style.
A task is provided to format project files using the Prettier code formatting tool.

A GitHub Actions workflow is included to automatically run the task. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
On every push and pull request that affects relevant files, check whether the formatting of supported files is compliant with the [Prettier](https://prettier.io/docs/en/index.html) style.
A task is provided to format project files using the [**Prettier**](https://prettier.io/docs/en/index.html) code formatting tool.

A GitHub Actions workflow is included to automatically run the task. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```
24 changes: 15 additions & 9 deletions workflow-templates/check-shell-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,23 +70,29 @@ Define the `{repository-owner}` and `{repository-name}` attributes and use them
## Commit message

```
Add CI workflow to check for problems with shell scripts
Add infrastructure to check for problems with shell scripts

On every push or pull request that modifies one of the shell scripts in the repository, and periodically, the workflow:
Tasks are provided to facilitate the development of the project's shell scripts:

- Runs ShellCheck to detect common problems.
- Runs shfmt to check formatting.
- Checks for forgotten executable script file permissions.
- Detect common problems using ShellCheck.
- Format using shfmt.
- Check for forgotten executable script file permissions.

A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that
changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also
triggered periodically, in order to catch breakage caused by external changes.
```

## PR message

```markdown
On every push or pull request that modifies one of the shell scripts in the repository, and periodically, the workflow:
Tasks are provided to facilitate the development of the project's shell scripts:

- Detect common problems using [**ShellCheck**](https://github.com/koalaman/shellcheck).
- Format using [**shfmt**](https://github.com/mvdan/sh).
- Check for forgotten executable script file permissions.

- Runs [ShellCheck](https://github.com/koalaman/shellcheck) to detect common problems.
- Runs [`shfmt`](https://github.com/mvdan/sh) to check formatting.
- Checks for forgotten executable script file permissions.
A GitHub Actions workflow is included to automatically run the tasks. The workflow is triggered on any push or pull that changes relevant project files, in order to avoid the introduction of problems with the project filesystem. It is also triggered periodically, in order to catch breakage caused by external changes.
```

## Usage
Expand Down
Loading
Loading