From 794346ed997b493c249681e78f7008f9427a5f30 Mon Sep 17 00:00:00 2001 From: Isaac Good Date: Mon, 25 May 2026 15:34:26 -0700 Subject: [PATCH 1/2] Format all `instructions.append.md` to start with an H1 (required but ignored) and H2 --- exercises/practice/anagram/.docs/instructions.append.md | 2 ++ exercises/practice/forth/.docs/instructions.append.md | 8 +++++--- .../practice/gigasecond/.docs/instructions.append.md | 2 ++ .../practice/hello-world/.docs/instructions.append.md | 2 ++ exercises/practice/leap/.docs/instructions.append.md | 2 ++ exercises/practice/nth-prime/.docs/instructions.append.md | 5 ++++- exercises/practice/series/.docs/instructions.append.md | 3 +++ exercises/practice/wordy/.docs/instructions.append.md | 4 +++- 8 files changed, 23 insertions(+), 5 deletions(-) diff --git a/exercises/practice/anagram/.docs/instructions.append.md b/exercises/practice/anagram/.docs/instructions.append.md index 85e50cb5fc8..439c96978ed 100644 --- a/exercises/practice/anagram/.docs/instructions.append.md +++ b/exercises/practice/anagram/.docs/instructions.append.md @@ -1,5 +1,7 @@ # Instructions append +## Implementation + The Rust track extends the possible letters to be any unicode character, not just ASCII alphabetic ones. You are going to have to adjust the function signature provided in the stub in order for the lifetimes to work out properly. diff --git a/exercises/practice/forth/.docs/instructions.append.md b/exercises/practice/forth/.docs/instructions.append.md index 947eed8e1fd..711174db949 100644 --- a/exercises/practice/forth/.docs/instructions.append.md +++ b/exercises/practice/forth/.docs/instructions.append.md @@ -1,5 +1,7 @@ # Instructions append -Note the additional test case in `tests/alloc-attack.rs`. It tests against -algorithmically inefficient implementations. Because of that, it usually times -out online instead of outright failing, leading to a less helpful error message. +## Implementation + +Note the additional test case in `tests/alloc-attack.rs`. +It tests against algorithmically inefficient implementations. +Because of that, it usually times out online instead of outright failing, leading to a less helpful error message. diff --git a/exercises/practice/gigasecond/.docs/instructions.append.md b/exercises/practice/gigasecond/.docs/instructions.append.md index 5939c90249e..9d76bef0a81 100644 --- a/exercises/practice/gigasecond/.docs/instructions.append.md +++ b/exercises/practice/gigasecond/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append +## Implementation + If you're unsure what operations you can perform on `PrimitiveDateTime` take a look at the [time crate](https://docs.rs/time) which is listed as a dependency in the `Cargo.toml` file for this exercise. diff --git a/exercises/practice/hello-world/.docs/instructions.append.md b/exercises/practice/hello-world/.docs/instructions.append.md index d1429012662..578ab6ca1b6 100644 --- a/exercises/practice/hello-world/.docs/instructions.append.md +++ b/exercises/practice/hello-world/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append +## Implementation + In the Rust track, tests are run using the command `cargo test`. diff --git a/exercises/practice/leap/.docs/instructions.append.md b/exercises/practice/leap/.docs/instructions.append.md index 98e55679f4c..1e08b767c06 100644 --- a/exercises/practice/leap/.docs/instructions.append.md +++ b/exercises/practice/leap/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append +## Implementation + You may use the [`arithmetic remainder` operator](https://doc.rust-lang.org/book/appendix-02-operators.html) to test for divisibility. diff --git a/exercises/practice/nth-prime/.docs/instructions.append.md b/exercises/practice/nth-prime/.docs/instructions.append.md index fe218094f8f..30d15827e21 100644 --- a/exercises/practice/nth-prime/.docs/instructions.append.md +++ b/exercises/practice/nth-prime/.docs/instructions.append.md @@ -1,3 +1,6 @@ # Instructions append -Remember that while people commonly count with 1-based indexing (i.e. "the 6th prime is 13"), many programming languages, including Rust, use 0-based indexing (i.e. `primes[5] == 13`). Use 0-based indexing for your implementation. +## Implementation + +Remember that while people commonly count with 1-based indexing (i.e. "the 6th prime is 13"), many programming languages, including Rust, use 0-based indexing (i.e. `primes[5] == 13`). +Use 0-based indexing for your implementation. diff --git a/exercises/practice/series/.docs/instructions.append.md b/exercises/practice/series/.docs/instructions.append.md index a45087895f3..4aa7cc82fb3 100644 --- a/exercises/practice/series/.docs/instructions.append.md +++ b/exercises/practice/series/.docs/instructions.append.md @@ -1,9 +1,12 @@ # Instructions append +## Implementation + Different languages on Exercism have different expectations about what the result should be if the length of the substrings is zero. On the Rust track, we don't have a test for that case, so you are free to do what you feel is most appropriate. Consider the advantages and disadvantages of the following possibilities: + - Crash the program with `panic!`. - Return a `Result::Err`. (not possible here, because the function signature is given) - Return an empty vector. diff --git a/exercises/practice/wordy/.docs/instructions.append.md b/exercises/practice/wordy/.docs/instructions.append.md index 691fb883b14..050f8ce9c81 100644 --- a/exercises/practice/wordy/.docs/instructions.append.md +++ b/exercises/practice/wordy/.docs/instructions.append.md @@ -1,7 +1,9 @@ # Instructions append +## Implementation + To get the bonus tests to run, execute the tests with: ```bash $ cargo test --features exponentials -``` \ No newline at end of file +``` From 888f420000fe3300ed1a42f20c40a1ed6d3a312e Mon Sep 17 00:00:00 2001 From: Isaac Good Date: Tue, 26 May 2026 08:55:31 -0700 Subject: [PATCH 2/2] Craft specific headers. Revert whitespace fixes. --- exercises/practice/anagram/.docs/instructions.append.md | 2 +- exercises/practice/forth/.docs/instructions.append.md | 8 ++++---- .../practice/gigasecond/.docs/instructions.append.md | 2 +- .../practice/hello-world/.docs/instructions.append.md | 2 +- exercises/practice/leap/.docs/instructions.append.md | 2 +- exercises/practice/nth-prime/.docs/instructions.append.md | 5 ++--- exercises/practice/series/.docs/instructions.append.md | 3 +-- exercises/practice/wordy/.docs/instructions.append.md | 2 +- 8 files changed, 12 insertions(+), 14 deletions(-) diff --git a/exercises/practice/anagram/.docs/instructions.append.md b/exercises/practice/anagram/.docs/instructions.append.md index 439c96978ed..c72b4fa8deb 100644 --- a/exercises/practice/anagram/.docs/instructions.append.md +++ b/exercises/practice/anagram/.docs/instructions.append.md @@ -1,6 +1,6 @@ # Instructions append -## Implementation +## Unicode and lifetimes The Rust track extends the possible letters to be any unicode character, not just ASCII alphabetic ones. diff --git a/exercises/practice/forth/.docs/instructions.append.md b/exercises/practice/forth/.docs/instructions.append.md index 711174db949..50027fee34f 100644 --- a/exercises/practice/forth/.docs/instructions.append.md +++ b/exercises/practice/forth/.docs/instructions.append.md @@ -1,7 +1,7 @@ # Instructions append -## Implementation +## Efficient Allocation -Note the additional test case in `tests/alloc-attack.rs`. -It tests against algorithmically inefficient implementations. -Because of that, it usually times out online instead of outright failing, leading to a less helpful error message. +Note the additional test case in `tests/alloc-attack.rs`. It tests against +algorithmically inefficient implementations. Because of that, it usually times +out online instead of outright failing, leading to a less helpful error message. diff --git a/exercises/practice/gigasecond/.docs/instructions.append.md b/exercises/practice/gigasecond/.docs/instructions.append.md index 9d76bef0a81..1850f8b8f81 100644 --- a/exercises/practice/gigasecond/.docs/instructions.append.md +++ b/exercises/practice/gigasecond/.docs/instructions.append.md @@ -1,5 +1,5 @@ # Instructions append -## Implementation +## The time crate If you're unsure what operations you can perform on `PrimitiveDateTime` take a look at the [time crate](https://docs.rs/time) which is listed as a dependency in the `Cargo.toml` file for this exercise. diff --git a/exercises/practice/hello-world/.docs/instructions.append.md b/exercises/practice/hello-world/.docs/instructions.append.md index 578ab6ca1b6..4ca391c0aac 100644 --- a/exercises/practice/hello-world/.docs/instructions.append.md +++ b/exercises/practice/hello-world/.docs/instructions.append.md @@ -1,5 +1,5 @@ # Instructions append -## Implementation +## Running tests In the Rust track, tests are run using the command `cargo test`. diff --git a/exercises/practice/leap/.docs/instructions.append.md b/exercises/practice/leap/.docs/instructions.append.md index 1e08b767c06..2436d78d1d6 100644 --- a/exercises/practice/leap/.docs/instructions.append.md +++ b/exercises/practice/leap/.docs/instructions.append.md @@ -1,5 +1,5 @@ # Instructions append -## Implementation +## Remainder operation You may use the [`arithmetic remainder` operator](https://doc.rust-lang.org/book/appendix-02-operators.html) to test for divisibility. diff --git a/exercises/practice/nth-prime/.docs/instructions.append.md b/exercises/practice/nth-prime/.docs/instructions.append.md index 30d15827e21..1833f09e4ad 100644 --- a/exercises/practice/nth-prime/.docs/instructions.append.md +++ b/exercises/practice/nth-prime/.docs/instructions.append.md @@ -1,6 +1,5 @@ # Instructions append -## Implementation +## Zero based indexing -Remember that while people commonly count with 1-based indexing (i.e. "the 6th prime is 13"), many programming languages, including Rust, use 0-based indexing (i.e. `primes[5] == 13`). -Use 0-based indexing for your implementation. +Remember that while people commonly count with 1-based indexing (i.e. "the 6th prime is 13"), many programming languages, including Rust, use 0-based indexing (i.e. `primes[5] == 13`). Use 0-based indexing for your implementation. diff --git a/exercises/practice/series/.docs/instructions.append.md b/exercises/practice/series/.docs/instructions.append.md index 4aa7cc82fb3..059baee300d 100644 --- a/exercises/practice/series/.docs/instructions.append.md +++ b/exercises/practice/series/.docs/instructions.append.md @@ -1,12 +1,11 @@ # Instructions append -## Implementation +## Handling edge cases Different languages on Exercism have different expectations about what the result should be if the length of the substrings is zero. On the Rust track, we don't have a test for that case, so you are free to do what you feel is most appropriate. Consider the advantages and disadvantages of the following possibilities: - - Crash the program with `panic!`. - Return a `Result::Err`. (not possible here, because the function signature is given) - Return an empty vector. diff --git a/exercises/practice/wordy/.docs/instructions.append.md b/exercises/practice/wordy/.docs/instructions.append.md index 050f8ce9c81..30daeac6ef6 100644 --- a/exercises/practice/wordy/.docs/instructions.append.md +++ b/exercises/practice/wordy/.docs/instructions.append.md @@ -1,6 +1,6 @@ # Instructions append -## Implementation +## Bonus tests To get the bonus tests to run, execute the tests with: