From d7f7735a6497f9fa16549abc876b76ad5f7eb519 Mon Sep 17 00:00:00 2001 From: Isaac Good Date: Mon, 25 May 2026 13:56:00 -0700 Subject: [PATCH] Format all `instructions.append.md` to start with an H1 (required but ignored) and H2 --- exercises/practice/accumulate/.docs/instructions.append.md | 4 +++- exercises/practice/alphametics/.docs/instructions.append.md | 4 +++- exercises/practice/anagram/.docs/instructions.append.md | 2 ++ exercises/practice/beer-song/.docs/instructions.append.md | 4 +++- exercises/practice/diamond/.docs/instructions.append.md | 4 +++- .../difference-of-squares/.docs/instructions.append.md | 4 +++- .../practice/diffie-hellman/.docs/instructions.append.md | 4 +++- exercises/practice/food-chain/.docs/instructions.append.md | 4 +++- exercises/practice/grade-school/.docs/instructions.append.md | 4 +++- exercises/practice/grains/.docs/instructions.append.md | 4 +++- exercises/practice/house/.docs/instructions.append.md | 4 +++- exercises/practice/leap/.docs/instructions.append.md | 4 +++- exercises/practice/lens-person/.docs/instructions.append.md | 4 +++- exercises/practice/linked-list/.docs/instructions.append.md | 4 +++- exercises/practice/nth-prime/.docs/instructions.append.md | 4 +++- .../practice/palindrome-products/.docs/instructions.append.md | 4 +++- .../parallel-letter-frequency/.docs/instructions.append.md | 4 +++- exercises/practice/poker/.docs/instructions.append.md | 4 +++- exercises/practice/proverb/.docs/instructions.append.md | 4 +++- exercises/practice/raindrops/.docs/instructions.append.md | 4 +++- .../practice/rna-transcription/.docs/instructions.append.md | 4 +++- exercises/practice/space-age/.docs/instructions.append.md | 4 +++- exercises/practice/twelve-days/.docs/instructions.append.md | 4 +++- exercises/practice/wordy/.docs/instructions.append.md | 4 +++- 24 files changed, 71 insertions(+), 23 deletions(-) diff --git a/exercises/practice/accumulate/.docs/instructions.append.md b/exercises/practice/accumulate/.docs/instructions.append.md index 4e87edd63..508c7d557 100644 --- a/exercises/practice/accumulate/.docs/instructions.append.md +++ b/exercises/practice/accumulate/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# feature comes in handy: diff --git a/exercises/practice/alphametics/.docs/instructions.append.md b/exercises/practice/alphametics/.docs/instructions.append.md index b37c95c58..be4b63369 100644 --- a/exercises/practice/alphametics/.docs/instructions.append.md +++ b/exercises/practice/alphametics/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints - To parse the text, you could try to use the [FParsec](http://www.quanttec.com/fparsec/tutorial.html) library. - You can solve this exercise with a brute force algorithm, but this will possibly have a poor runtime performance. diff --git a/exercises/practice/anagram/.docs/instructions.append.md b/exercises/practice/anagram/.docs/instructions.append.md index 2b17bb7a3..bd152ab13 100644 --- a/exercises/practice/anagram/.docs/instructions.append.md +++ b/exercises/practice/anagram/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions Append +## Note + You must return the anagrams in the same order as they are listed in the candidate words. diff --git a/exercises/practice/beer-song/.docs/instructions.append.md b/exercises/practice/beer-song/.docs/instructions.append.md index a2eb39766..63983bd09 100644 --- a/exercises/practice/beer-song/.docs/instructions.append.md +++ b/exercises/practice/beer-song/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - Try to capture the structure of the song in your code, where you build up the song by composing its parts. diff --git a/exercises/practice/diamond/.docs/instructions.append.md b/exercises/practice/diamond/.docs/instructions.append.md index 5f85c9a5c..5884a5be7 100644 --- a/exercises/practice/diamond/.docs/instructions.append.md +++ b/exercises/practice/diamond/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - Testing this one can be tricky without simply hardcoding a bunch of inputs and outputs. [Property based testing](https://fsharpforfunandprofit.com/posts/property-based-testing/) is another way to think about testing that allows you to more easily test this type of algorithm. diff --git a/exercises/practice/difference-of-squares/.docs/instructions.append.md b/exercises/practice/difference-of-squares/.docs/instructions.append.md index 97f15dc31..202c9c1f4 100644 --- a/exercises/practice/difference-of-squares/.docs/instructions.append.md +++ b/exercises/practice/difference-of-squares/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# features come in handy: - [(..) start finish](https://fsharp.github.io/fsharp-core-docs/reference/fsharp-core-operators.html#(..)) allows you to succinctly create a range of values. diff --git a/exercises/practice/diffie-hellman/.docs/instructions.append.md b/exercises/practice/diffie-hellman/.docs/instructions.append.md index 35bbcfc5d..1681da252 100644 --- a/exercises/practice/diffie-hellman/.docs/instructions.append.md +++ b/exercises/practice/diffie-hellman/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# feature comes in handy: diff --git a/exercises/practice/food-chain/.docs/instructions.append.md b/exercises/practice/food-chain/.docs/instructions.append.md index a2eb39766..63983bd09 100644 --- a/exercises/practice/food-chain/.docs/instructions.append.md +++ b/exercises/practice/food-chain/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - Try to capture the structure of the song in your code, where you build up the song by composing its parts. diff --git a/exercises/practice/grade-school/.docs/instructions.append.md b/exercises/practice/grade-school/.docs/instructions.append.md index 7ced280cd..9eae2b5b3 100644 --- a/exercises/practice/grade-school/.docs/instructions.append.md +++ b/exercises/practice/grade-school/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# feature comes in handy: diff --git a/exercises/practice/grains/.docs/instructions.append.md b/exercises/practice/grains/.docs/instructions.append.md index 2ec881da9..7c92a7b5c 100644 --- a/exercises/practice/grains/.docs/instructions.append.md +++ b/exercises/practice/grains/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# features come in handy: diff --git a/exercises/practice/house/.docs/instructions.append.md b/exercises/practice/house/.docs/instructions.append.md index a2eb39766..63983bd09 100644 --- a/exercises/practice/house/.docs/instructions.append.md +++ b/exercises/practice/house/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - Try to capture the structure of the song in your code, where you build up the song by composing its parts. diff --git a/exercises/practice/leap/.docs/instructions.append.md b/exercises/practice/leap/.docs/instructions.append.md index 0f9bd770b..3f3d5b41b 100644 --- a/exercises/practice/leap/.docs/instructions.append.md +++ b/exercises/practice/leap/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Notes +# Instructions append + +## Notes The [DateTime class][datetime] provides a built-in [IsLeapYear][datetime.isleapyear] method which you should pretend doesn't exist for the purposes of implementing this exercise. diff --git a/exercises/practice/lens-person/.docs/instructions.append.md b/exercises/practice/lens-person/.docs/instructions.append.md index 83ef36b82..613a46c91 100644 --- a/exercises/practice/lens-person/.docs/instructions.append.md +++ b/exercises/practice/lens-person/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - This exercise expects you to use the [Aether](https://xyncro.tech/aether/) library, which adds _lenses_ functionality to F#. With lenses, you can quite easily read or update nested structures. diff --git a/exercises/practice/linked-list/.docs/instructions.append.md b/exercises/practice/linked-list/.docs/instructions.append.md index 44f63e991..d422a2258 100644 --- a/exercises/practice/linked-list/.docs/instructions.append.md +++ b/exercises/practice/linked-list/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints A [doubly linked list](https://en.wikipedia.org/wiki/Doubly_linked_list) is a mutable data structure. As F# is a functional-first language, immutability is generally preferred, but there are language features that allow the use of mutation where it is required. diff --git a/exercises/practice/nth-prime/.docs/instructions.append.md b/exercises/practice/nth-prime/.docs/instructions.append.md index 3858e3f83..03e181f2a 100644 --- a/exercises/practice/nth-prime/.docs/instructions.append.md +++ b/exercises/practice/nth-prime/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# feature comes in handy: diff --git a/exercises/practice/palindrome-products/.docs/instructions.append.md b/exercises/practice/palindrome-products/.docs/instructions.append.md index 978d82946..61b292fb4 100644 --- a/exercises/practice/palindrome-products/.docs/instructions.append.md +++ b/exercises/practice/palindrome-products/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - The most simple way to check if a number is a palindrome is quite slow. To speed things up, you could implement a slighly more complex algorithm which uses mutable state. diff --git a/exercises/practice/parallel-letter-frequency/.docs/instructions.append.md b/exercises/practice/parallel-letter-frequency/.docs/instructions.append.md index 4e496b078..d411a94fb 100644 --- a/exercises/practice/parallel-letter-frequency/.docs/instructions.append.md +++ b/exercises/practice/parallel-letter-frequency/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# feature comes in handy: diff --git a/exercises/practice/poker/.docs/instructions.append.md b/exercises/practice/poker/.docs/instructions.append.md index d6aa6324f..5ddcf934d 100644 --- a/exercises/practice/poker/.docs/instructions.append.md +++ b/exercises/practice/poker/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - [Designing with types](http://fsharpforfunandprofit.com/series/designing-with-types.html) To come up with a clean and easy to read solution for this make sure to choose the right types to represent the different parts of the problem (think of suits, values, cards, etc) diff --git a/exercises/practice/proverb/.docs/instructions.append.md b/exercises/practice/proverb/.docs/instructions.append.md index a2eb39766..63983bd09 100644 --- a/exercises/practice/proverb/.docs/instructions.append.md +++ b/exercises/practice/proverb/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - Try to capture the structure of the song in your code, where you build up the song by composing its parts. diff --git a/exercises/practice/raindrops/.docs/instructions.append.md b/exercises/practice/raindrops/.docs/instructions.append.md index 01aa947fb..e456c46f8 100644 --- a/exercises/practice/raindrops/.docs/instructions.append.md +++ b/exercises/practice/raindrops/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - Think of this in a generic way. If you're familiar with the (fizz buzz)[https://en.wikipedia.org/wiki/Fizz_buzz] problem this is similar except there are three conditions instead of two. How would you implement this knowing that one day we might want to extend to four, five, or even ten types of raindrops? diff --git a/exercises/practice/rna-transcription/.docs/instructions.append.md b/exercises/practice/rna-transcription/.docs/instructions.append.md index a61a70d27..02dc66fdc 100644 --- a/exercises/practice/rna-transcription/.docs/instructions.append.md +++ b/exercises/practice/rna-transcription/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints For this exercise the following F# feature comes in handy: diff --git a/exercises/practice/space-age/.docs/instructions.append.md b/exercises/practice/space-age/.docs/instructions.append.md index 4dc4ec824..2518727cc 100644 --- a/exercises/practice/space-age/.docs/instructions.append.md +++ b/exercises/practice/space-age/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints - Try to focus on minimizing the amount of code duplication. If you find yourself doing a lot of copy/paste take a step back and think about how the code can be refactored - [Pattern matching](https://fsharpforfunandprofit.com/posts/match-expression/) is more idiomatic than using dictionaries to translate values diff --git a/exercises/practice/twelve-days/.docs/instructions.append.md b/exercises/practice/twelve-days/.docs/instructions.append.md index a2eb39766..63983bd09 100644 --- a/exercises/practice/twelve-days/.docs/instructions.append.md +++ b/exercises/practice/twelve-days/.docs/instructions.append.md @@ -1,3 +1,5 @@ -# Hints +# Instructions append + +## Hints - Try to capture the structure of the song in your code, where you build up the song by composing its parts. diff --git a/exercises/practice/wordy/.docs/instructions.append.md b/exercises/practice/wordy/.docs/instructions.append.md index d5bfc2032..c8a3a69ce 100644 --- a/exercises/practice/wordy/.docs/instructions.append.md +++ b/exercises/practice/wordy/.docs/instructions.append.md @@ -1,4 +1,6 @@ -# Hints +# Instructions append + +## Hints - To parse the text, you could try to use the [FParsec](http://www.quanttec.com/fparsec/tutorial.html) library. - As an exercise, you could try to represent a question as an [Abstract Syntax Tree](https://en.wikipedia.org/wiki/Abstract_syntax_tree).