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 85e50cb5f..439c96978 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 947eed8e1..711174db9 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 5939c9024..9d76bef0a 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 d14290126..578ab6ca1 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 98e55679f..1e08b767c 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 fe218094f..30d15827e 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 a45087895..4aa7cc82f 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 691fb883b..050f8ce9c 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 439c96978..c72b4fa8d 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 711174db9..50027fee3 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 9d76bef0a..1850f8b8f 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 578ab6ca1..4ca391c0a 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 1e08b767c..2436d78d1 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 30d15827e..1833f09e4 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 4aa7cc82f..059baee30 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 050f8ce9c..30daeac6e 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: