From b122f4f822a3c121d8a4b0d845c33a5282bf47ab Mon Sep 17 00:00:00 2001
From: Isaac Good <github@isaacgood.com>
Date: Mon, 25 May 2026 14:22:29 -0700
Subject: [PATCH 1/2] Format all `instructions.append.md` to start with an H1
 (required but ignored) and H2

---
 exercises/practice/all-your-base/.docs/instructions.append.md   | 2 ++
 exercises/practice/allergies/.docs/instructions.append.md       | 2 ++
 exercises/practice/anagram/.docs/instructions.append.md         | 2 ++
 .../practice/kindergarten-garden/.docs/instructions.append.md   | 2 ++
 .../practice/pascals-triangle/.docs/instructions.append.md      | 2 ++
 exercises/practice/robot-simulator/.docs/instructions.append.md | 2 ++
 exercises/practice/space-age/.docs/instructions.append.md       | 2 ++
 .../practice/sum-of-multiples/.docs/instructions.append.md      | 2 ++
 exercises/practice/yacht/.docs/instructions.append.md           | 2 ++
 9 files changed, 18 insertions(+)

diff --git a/exercises/practice/all-your-base/.docs/instructions.append.md b/exercises/practice/all-your-base/.docs/instructions.append.md
index 530f79e..cb9905d 100644
--- a/exercises/practice/all-your-base/.docs/instructions.append.md
+++ b/exercises/practice/all-your-base/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Additional Information
 
 ### Example Input
diff --git a/exercises/practice/allergies/.docs/instructions.append.md b/exercises/practice/allergies/.docs/instructions.append.md
index 77084b9..622e456 100644
--- a/exercises/practice/allergies/.docs/instructions.append.md
+++ b/exercises/practice/allergies/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Notes
 
 You need to define two verbs called `allergic_to` and `list`
diff --git a/exercises/practice/anagram/.docs/instructions.append.md b/exercises/practice/anagram/.docs/instructions.append.md
index 6882071..53b60ab 100644
--- a/exercises/practice/anagram/.docs/instructions.append.md
+++ b/exercises/practice/anagram/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Additional Information
 
 ### Input
diff --git a/exercises/practice/kindergarten-garden/.docs/instructions.append.md b/exercises/practice/kindergarten-garden/.docs/instructions.append.md
index 3ff10ed..cf70811 100644
--- a/exercises/practice/kindergarten-garden/.docs/instructions.append.md
+++ b/exercises/practice/kindergarten-garden/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Notes
 
 Here's what you need to know about the input format:
diff --git a/exercises/practice/pascals-triangle/.docs/instructions.append.md b/exercises/practice/pascals-triangle/.docs/instructions.append.md
index 7f8d79a..48361d3 100644
--- a/exercises/practice/pascals-triangle/.docs/instructions.append.md
+++ b/exercises/practice/pascals-triangle/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Output
 In this exercise, you will implement a verb that generates Pascal’s Triangle up to a given number of rows. The output from your verb can be formatted in one of two ways:
 
diff --git a/exercises/practice/robot-simulator/.docs/instructions.append.md b/exercises/practice/robot-simulator/.docs/instructions.append.md
index 47a6d93..a41ea8e 100644
--- a/exercises/practice/robot-simulator/.docs/instructions.append.md
+++ b/exercises/practice/robot-simulator/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Notes
 
 For this exercise you need to define a **locale** named `robot` that defines the **nouns** `position` and `direction` and a **verb** `move`.
diff --git a/exercises/practice/space-age/.docs/instructions.append.md b/exercises/practice/space-age/.docs/instructions.append.md
index d8a7a13..449d168 100644
--- a/exercises/practice/space-age/.docs/instructions.append.md
+++ b/exercises/practice/space-age/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Notes
 
 Here's what you need to know about the input format:
diff --git a/exercises/practice/sum-of-multiples/.docs/instructions.append.md b/exercises/practice/sum-of-multiples/.docs/instructions.append.md
index 078ce97..ff229c3 100644
--- a/exercises/practice/sum-of-multiples/.docs/instructions.append.md
+++ b/exercises/practice/sum-of-multiples/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Notes
 
 For this exercise, your verb will receive two arguments:
diff --git a/exercises/practice/yacht/.docs/instructions.append.md b/exercises/practice/yacht/.docs/instructions.append.md
index b7dabd7..7cf03f9 100644
--- a/exercises/practice/yacht/.docs/instructions.append.md
+++ b/exercises/practice/yacht/.docs/instructions.append.md
@@ -1,3 +1,5 @@
+# Instructions append
+
 ## Notes
 
 In the "Yacht" exercise, you will create a verb that calculates the score for a single throw of five dice in the game Yacht, based on the chosen category.

From 4f3caff68b788e16e9770e460296083cfd325c2b Mon Sep 17 00:00:00 2001
From: Isaac Good <github@isaacgood.com>
Date: Tue, 26 May 2026 22:17:06 -0700
Subject: [PATCH 2/2] Update the header to "Track specific instructions"

---
 .../all-your-base/.docs/instructions.append.md        |  8 +++-----
 .../practice/allergies/.docs/instructions.append.md   | 11 +++++++----
 .../practice/anagram/.docs/instructions.append.md     |  6 ++----
 .../kindergarten-garden/.docs/instructions.append.md  |  2 +-
 .../pascals-triangle/.docs/instructions.append.md     |  3 +++
 .../robot-simulator/.docs/instructions.append.md      |  2 +-
 .../practice/space-age/.docs/instructions.append.md   |  2 +-
 .../sum-of-multiples/.docs/instructions.append.md     |  2 +-
 exercises/practice/yacht/.docs/instructions.append.md |  2 +-
 9 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/exercises/practice/all-your-base/.docs/instructions.append.md b/exercises/practice/all-your-base/.docs/instructions.append.md
index cb9905d..a13c269 100644
--- a/exercises/practice/all-your-base/.docs/instructions.append.md
+++ b/exercises/practice/all-your-base/.docs/instructions.append.md
@@ -1,8 +1,6 @@
 # Instructions append
 
-## Additional Information
-
-### Example Input
+## Example Input
 
 ```j
   INPUTS=: 2 ; 1 0 0 1 0 1 ; 10
@@ -14,11 +12,11 @@ This means that your inputs are:
   1{INPUTS NB. is the digits.
   2{INPUTS NB. is the output base.
 ```
-### Handling Invalid Inputs
+## Handling Invalid Inputs
 
 If any of the input values is invalid, your verb should return either an `empty`(e.g., `0$0` or `''`).
 
-#### Examples
+### Examples
 
 - If the _input base_ is smaller than 2:
     ```j
diff --git a/exercises/practice/allergies/.docs/instructions.append.md b/exercises/practice/allergies/.docs/instructions.append.md
index 622e456..7728fd3 100644
--- a/exercises/practice/allergies/.docs/instructions.append.md
+++ b/exercises/practice/allergies/.docs/instructions.append.md
@@ -1,10 +1,11 @@
 # Instructions append
 
-## Notes
+## Track specific instructions
 
-You need to define two verbs called `allergic_to` and `list`
+You need to define two verbs called `allergic_to` and `list`.
+
+## Inputs
 
-### Inputs
 1. `allergic_to` verb is **dyad** where:
 
     - **Left Argument**: is a string containing the allergen name.
@@ -20,7 +21,9 @@ Your verbs will be called with these arguments like so:
   'cats' allergic_to 255
   list 5
 ```
-### Outputs
+
+## Outputs
+
 The output of `allergic_to` verb is a **boolean**
 
 The output of `list` is a **list of boxes**
diff --git a/exercises/practice/anagram/.docs/instructions.append.md b/exercises/practice/anagram/.docs/instructions.append.md
index 53b60ab..524b3e7 100644
--- a/exercises/practice/anagram/.docs/instructions.append.md
+++ b/exercises/practice/anagram/.docs/instructions.append.md
@@ -1,8 +1,6 @@
 # Instructions append
 
-## Additional Information
-
-### Input
+# Input
 
 The input for this exercise are:
 
@@ -18,6 +16,6 @@ Your verb will be called like this:
   subject findAnagrams candidates
 ```
 
-### Output
+## Output
 
 Your verb should return a _list_ of boxes containig the strings that are anagrams of the target. If there are no anagrams, the result should be `empty`.
diff --git a/exercises/practice/kindergarten-garden/.docs/instructions.append.md b/exercises/practice/kindergarten-garden/.docs/instructions.append.md
index cf70811..f717133 100644
--- a/exercises/practice/kindergarten-garden/.docs/instructions.append.md
+++ b/exercises/practice/kindergarten-garden/.docs/instructions.append.md
@@ -1,6 +1,6 @@
 # Instructions append
 
-## Notes
+## Track specific instructions
 
 Here's what you need to know about the input format:
 
diff --git a/exercises/practice/pascals-triangle/.docs/instructions.append.md b/exercises/practice/pascals-triangle/.docs/instructions.append.md
index 48361d3..1df0666 100644
--- a/exercises/practice/pascals-triangle/.docs/instructions.append.md
+++ b/exercises/practice/pascals-triangle/.docs/instructions.append.md
@@ -1,11 +1,14 @@
 # Instructions append
 
 ## Output
+
 In this exercise, you will implement a verb that generates Pascal’s Triangle up to a given number of rows. The output from your verb can be formatted in one of two ways:
 
   1. As an array of boxed lists, where each list represents a row in Pascal’s Triangle.
   1. As a table, where the numbers are aligned to the right, and zeros are used to fill empty spaces on the left.
+
 ### Example output
+
 Here are two valid outputs for `pascal 3`:
 
   - As an array of boxed lists:
diff --git a/exercises/practice/robot-simulator/.docs/instructions.append.md b/exercises/practice/robot-simulator/.docs/instructions.append.md
index a41ea8e..0b2a311 100644
--- a/exercises/practice/robot-simulator/.docs/instructions.append.md
+++ b/exercises/practice/robot-simulator/.docs/instructions.append.md
@@ -1,6 +1,6 @@
 # Instructions append
 
-## Notes
+## Track specific instructions
 
 For this exercise you need to define a **locale** named `robot` that defines the **nouns** `position` and `direction` and a **verb** `move`.
 
diff --git a/exercises/practice/space-age/.docs/instructions.append.md b/exercises/practice/space-age/.docs/instructions.append.md
index 449d168..374455a 100644
--- a/exercises/practice/space-age/.docs/instructions.append.md
+++ b/exercises/practice/space-age/.docs/instructions.append.md
@@ -1,6 +1,6 @@
 # Instructions append
 
-## Notes
+## Track specific instructions
 
 Here's what you need to know about the input format:
 
diff --git a/exercises/practice/sum-of-multiples/.docs/instructions.append.md b/exercises/practice/sum-of-multiples/.docs/instructions.append.md
index ff229c3..e0754d2 100644
--- a/exercises/practice/sum-of-multiples/.docs/instructions.append.md
+++ b/exercises/practice/sum-of-multiples/.docs/instructions.append.md
@@ -1,6 +1,6 @@
 # Instructions append
 
-## Notes
+## Track specific instructions
 
 For this exercise, your verb will receive two arguments:
 
diff --git a/exercises/practice/yacht/.docs/instructions.append.md b/exercises/practice/yacht/.docs/instructions.append.md
index 7cf03f9..dd6ae1c 100644
--- a/exercises/practice/yacht/.docs/instructions.append.md
+++ b/exercises/practice/yacht/.docs/instructions.append.md
@@ -1,6 +1,6 @@
 # Instructions append
 
-## Notes
+## Track specific instructions
 
 In the "Yacht" exercise, you will create a verb that calculates the score for a single throw of five dice in the game Yacht, based on the chosen category.