[v3] Prepare for v3

[ErikSchierboom]

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

This PR prepares the track for Exercism v3, which will be different in a number of ways from Exercism v2.

As having this PR merged is essential to prepare this track for Exercism v3, we'll automatically merge this PR one week after it was opened (if it hasn't been merged already).

In this PR, the following changes are made:

File migration

1. Move the existing exercises in the exercises directory to the exercises/practice directory

config.json migration

The config.json file is updated to conform to the v3 spec.

1. Add a version property:

"version": 3

2. Add online editor settings:

"online_editor": {
  "indent_style": "space",
  "indent_size": 2
}

Note: We recommend changing this to the correct settings as part of a seperate PR. We will open an issue on your track with more details. If this key was already defined, it is left unchanged.

3. Rename the "exercises" property to "practice"

4. Create an "exercises" property and move the "practice" property to this property:

"exercises": {
  "practice": [
    ...
  ]
}

5. Remove the "core", "auto_approve", and "unlocked_by" properties from the practice exercises

6. Add the "name" property to the practice exercises and pre-populate this with a titlelized version of the "slug" property

7. Add the "prerequisites" property to the practice exercises and set it to an empty array

8. Add an empty "concept" array property to the "exercises" property

"exercises": {
  "concept": [],
  "practice": [
    ...
  ]
}

9. Move the "foregone" property to the "exercises" key:

"exercises": {
  ...
  "foregone": [...]
}

10. Add a top-level "concepts" key, which is an array:

"concepts": []

11. Add a top-level "tags" key, which is an array:

"tags": []

12. Add a top-level "key_features" key, which is an array:

"key_features": []

13. Add a top-level "status" key, which is an object containing properties with boolean values indicating if a v3 feature is implemented:

"status": {
  "concept_exercises": true,
  "test_runner": true,
  "representer": false,
  "analyzer": false
}

14. Add a top-level "slug" key, which is a string containing the track's slug:

"slug": "csharp"

15. Re-order the practice exercises using the following ordering:

    1. Core exercises, retaining their existing ordering
    2. Non-core exercises, ordered by the order of the core exercise that unlocks them, then by difficulty and then alphabetically.
    3. Bonus exercises, ordered by difficulty then alphabetically.

16. Add the "status" key with a value of "deprecated" to practice exercises that have "deprecated" set to true. The deprecated field itself is removed:

{
  "slug": "octal",
  "name": "Octal",
  "uuid": "f29f9e56-c79b-4ae4-a0d0-29db78c677e4",
  "prerequisites": [],
  "difficulty": 0,
  "topics": ["integers"],
  "status": "deprecated"
}

configlet

1. Update the fetch-configlet and fetch-configlet.ps1 files to the latest version of configlet, which can work with v3 tracks.

Continuous integration

1. Add a GitHub Actions workflow to verify the track using the configlet-CI GitHub Action, unless there already is a file named .github/workflows/configlet.md.

2. Add a dependabot configuration to automatically submit PRs for any new versions of external workflows used in this track's GitHub Action workflows.

3. Convert any Exercism GitHub Actions workflows being used to use main as their branch instead of master. See this issue.

Follow-up steps

We've created issues in this repo for the follow-up steps to get this track ready for v3.

Tracking

exercism/v3-launch#11

[ErikSchierboom]

We are now merging these PRs automatically so that we can continue to script further bulk-PRs to help you. For many tracks this will break CI, but we consider this a reasonable tradeoff as all Exercism tracks are in a transitionary period between now and the launch of v3.