Pass linting checks

[ErikSchierboom]

This issue is part of the migration to v3. You can read full details about the various changes here.

The configlet tool has a lint command that checks if a track's configuration files are properly structured - both syntactically and semantically. Misconfigured tracks may not sync correctly, may look wrong on the website, or may present a suboptimal user experience, so configlet's guards play an important part in maintaining the integrity of Exercism.

We're updating configlet to work with v3 tracks, which have a different set of requirements than v2 tracks.

The full list of rules that will be checked by the linter can be found in this spec.

⚠ Note that only a subset of the linting rules has been implemented at this moment. This means that while your track may be passing the checks at this moment, it might fail later. We thus strongly suggest you keep this issue open until we let you know otherwise.

Goal

Ensure that the track passes all the (v3 track) checks defined in configlet lint.

To help verify that the track passes all the linting rules, the v3 preparation PR has added a GitHub Actions workflow that automatically runs configlet lint.

It is also possible to run configlet lint locally by running the ./bin/fetch-configlet (or ./bin/fetch-configlet.ps1) script to download a local copy of the configlet binary. Once downloaded, you can then do ./bin/configlet lint to run the linting on your own machine.

Tracking

exercism/v3-launch#3

[ErikSchierboom]

⚠ The original issue did not explain that currently only a subset of the linting rules have been implemented. This means that while your track may be passing the checks at this moment, it might fail later. We (the Exercism team) thus strongly suggest you keep this issue open until we let you know otherwise. The issue's text has been updated to reflect this.

[booniepepper]

@ErikSchierboom Is it safe to say that if we're passing configlet lint today, that we've addressed everything? Or are there still bits and pieces being implemented and I should take a manual look through the requirements? (Or maybe contribute to the lint itself?)

[ErikSchierboom]

@hiljusti We've not yet implemented all linting rules (see exercism/configlet#249), but we'll get there. We'll regularly release new builds, which will automatically run in GitHub Actions, so you'll notice it when doing PRs.

I'd keep this issue open for now.

[booniepepper]

Wow, that's quite a list!

Thanks, I'll keep this open till exercism/configlet#249 is closed