From 9a7af6e45f49584f39ebdb730cac634f081889c2 Mon Sep 17 00:00:00 2001 From: BethanyG Date: Thu, 28 May 2026 13:48:42 -0700 Subject: [PATCH 1/2] Updated notes and links and corrected append formatting. --- .../bank-account/.docs/instructions.append.md | 13 ++++++++++--- .../.docs/instructions.append.md | 13 ++++++++++++- .../sum-of-multiples/.docs/instructions.append.md | 13 ++++++++----- 3 files changed, 30 insertions(+), 9 deletions(-) diff --git a/exercises/practice/bank-account/.docs/instructions.append.md b/exercises/practice/bank-account/.docs/instructions.append.md index 0f71c081eb0..44d9838cd4c 100644 --- a/exercises/practice/bank-account/.docs/instructions.append.md +++ b/exercises/practice/bank-account/.docs/instructions.append.md @@ -1,18 +1,25 @@ # Instructions append ~~~~exercism/note + Python doesn't support "true" concurrency due to the [Global Interpreter Lock][GIL]. While work is ongoing to create support for [free-threading in Python][free-threading], it is still experimental. Current standard library solutions such as [multiprocessing][multiprocessing-module] and [threading][threading-module] are difficult to implement with the current track tooling. As a result, the concurrency requirement has been set aside for this exercise. -Account operations are sequential on a single thread, and no concurrency or "race condition" tests are run. +Account operations are sequential on a single thread, and no concurrency or "race condition" tests are run. -[GIL]: https://realpython.com/python-gil/ + +If you would like to experiment with free-threading or concurrency tests, we as that you do so [locally][testing-locally]. +For help with downloading and working on exercises locally, we recommend the [Exercism CLI][exercism-cli]. + +[exercism-cli]: https://exercism.org/cli-walkthrough [free-threading]: https://docs.python.org/3/howto/free-threading-python.html -[threading-module]: https://docs.python.org/3/library/threading.html#module-threading +[GIL]: https://realpython.com/python-gil/ [multiprocessing-module]: https://docs.python.org/3/library/multiprocessing.html#sharing-state-between-processes +[testing-locally]: https://exercism.org/docs/tracks/python/tests +[threading-module]: https://docs.python.org/3/library/threading.html#module-threading ~~~~
diff --git a/exercises/practice/pythagorean-triplet/.docs/instructions.append.md b/exercises/practice/pythagorean-triplet/.docs/instructions.append.md index 923f0301b00..e51e5aa0adc 100644 --- a/exercises/practice/pythagorean-triplet/.docs/instructions.append.md +++ b/exercises/practice/pythagorean-triplet/.docs/instructions.append.md @@ -1,3 +1,14 @@ # Instructions append -*NOTE*: The description above mentions mathematical sets, but also that a Pythagorean Triplet {a, b, c} _must_ be ordered such that a < b < c (ascending order). This makes Python's `set` type unsuited to this exercise, since it is an inherently unordered container. Therefore please return a list of lists instead (i.e. `[[a, b, c]]`). You can generate the triplets themselves in whatever order you would like, as the enclosing list's order will be ignored in the tests. +~~~~exercism/note + +The description above mentions [_mathematical sets_][math-sets], but also that a Pythagorean Triplet {a, b, c} _**must**_ be ordered such that a < b < c (_ascending order_). + +This makes Python's [`set` type][python-sets] unsuited to this exercise, since it is inherently _unordered_. +You should return a [`list`][python-list] of `list`s instead (_e.g. `[[a, b, c]]`_). +You can generate the triplets themselves in whichever order you would like, as the enclosing `list`'s order will be ignored in the tests. + +[math-sets]: https://en.wikipedia.org/wiki/Set_(mathematics) +[python-sets]: https://docs.python.org/3/tutorial/datastructures.html#sets +[python-list]: https://docs.python.org/3/tutorial/datastructures.html#more-on-lists +~~~~ diff --git a/exercises/practice/sum-of-multiples/.docs/instructions.append.md b/exercises/practice/sum-of-multiples/.docs/instructions.append.md index 610557b0c22..f23e2c78fc8 100644 --- a/exercises/practice/sum-of-multiples/.docs/instructions.append.md +++ b/exercises/practice/sum-of-multiples/.docs/instructions.append.md @@ -1,8 +1,11 @@ # Instructions append -You can make the following assumptions about the inputs to the +# Notes for this exercise on the Python track + +You can make the following assumptions about the test inputs to the `sum_of_multiples` function: -* All input numbers are non-negative `int`s, i.e. natural numbers -including zero. -* A list of factors must be given, and its elements are unique -and sorted in ascending order. \ No newline at end of file + +- All input numbers are **_non-negative `int`s_** (_i.e. natural numbers +including zero_). +- A `list` of factors must be given, and its elements are unique +and sorted in ascending order. From bdbb888699fb60b6f41db65c345d65356141991b Mon Sep 17 00:00:00 2001 From: BethanyG Date: Thu, 28 May 2026 14:28:14 -0700 Subject: [PATCH 2/2] Update exercises/practice/bank-account/.docs/instructions.append.md --- exercises/practice/bank-account/.docs/instructions.append.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exercises/practice/bank-account/.docs/instructions.append.md b/exercises/practice/bank-account/.docs/instructions.append.md index 44d9838cd4c..2e5c46f871b 100644 --- a/exercises/practice/bank-account/.docs/instructions.append.md +++ b/exercises/practice/bank-account/.docs/instructions.append.md @@ -11,7 +11,7 @@ As a result, the concurrency requirement has been set aside for this exercise. Account operations are sequential on a single thread, and no concurrency or "race condition" tests are run. -If you would like to experiment with free-threading or concurrency tests, we as that you do so [locally][testing-locally]. +If you would like to experiment with free-threading or concurrency tests, we ask that you do so [locally][testing-locally]. For help with downloading and working on exercises locally, we recommend the [Exercism CLI][exercism-cli]. [exercism-cli]: https://exercism.org/cli-walkthrough