Document snippet extension

exercism · ErikSchierboom · Nov 16, 2022 · Nov 15, 2022 · Nov 16, 2022 · Nov 15, 2022
commit 1c8ba89221a495b0c36cf37e36b233bd158cce1d
diff --git a/building/configlet/lint.md b/building/configlet/lint.md
@@ -375,10 +375,11 @@ The `config.json` file should have the following checks:
 - The Markdown must conform to the [Markdown standards](/docs/building/markdown/markdown)
 - Links must be absolute (relative links are not allowed)
 
-### Rule: exercises/{concept|practice}/&lt;slug&gt;/.approaches/&lt;approach-slug&gt;/snippet.txt is valid
+### Rule: exercises/{concept|practice}/&lt;slug&gt;/.approaches/&lt;approach-slug&gt;/snippet.&lt;snippet-extension&gt; is valid
 
 - The file's presence is required if a matching `"approaches[].slug"` entry exists in the `.approaches/config.json` file
 - The snippet must have at most 8 lines
+- The snippet extension is taken from the `approaches.snippet_extension` value in the track's `config.json` file
 
 ### Rule: exercises/{concept|practice}/&lt;slug&gt;/.articles/config.json is valid
 

diff --git a/building/tracks/approaches.md b/building/tracks/approaches.md
@@ -42,3 +42,7 @@ If you'd like to compare different approaches, please write an [articles](/docs/
 In general, [Practice Exercises](/docs/building/tracks/practice-exercises) are more suitable to write approaches for, as they usually can be solved in multiple ways.
 
 For [Concept Exercises](/docs/building/tracks/concept-exercises), discussing the exemplar approach might be interesting. For example, you could show how the concept being taught makes certain code easier to write.
+
+## Configuring
+
+Make sure to set the `approaches.snippet_extension` field in your [track's `config.json` file](/docs/building/tracks/config-json).
diff --git a/building/tracks/config-json.md b/building/tracks/config-json.md
@@ -28,6 +28,8 @@ The following top-level properties contain general track metadata:
   - `editor`: additional read-only editor file(s) patterns (optional)
 - `test_runner`: an object describing the track's test runner (if any): (required if `status.test_runner` is `true`)
   - `average_run_time`: a `number` value for the number of seconds the test runner takes on average to run, rounded to one decimal point precision (e.g. `1.8`) (required if `status.test_runner` is `true`)
+- `approaches`: an object with metadata on the track's approaches: (required if the track has any approaches)
+  - `snippet_extension`: a string value used for the snippet file's extension (e.g. `rb`) (required if the track has any approaches)
 
 ### Files
 
@@ -70,6 +72,9 @@ Support will be added to [configlet](/docs/building/configlet) to use these patt
   },
   "test_runner": {
     "average_run_time": 2.3
+  },
+  "approaches": {
+    "snippet_extension": "cs"
   }
 }
 ```