Skip to content

Commit 9a7af6e

Browse files
committed
Updated notes and links and corrected append formatting.
1 parent 223044e commit 9a7af6e

3 files changed

Lines changed: 30 additions & 9 deletions

File tree

exercises/practice/bank-account/.docs/instructions.append.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,25 @@
11
# Instructions append
22

33
~~~~exercism/note
4+
45
Python doesn't support "true" concurrency due to the [Global Interpreter Lock][GIL].
56
While work is ongoing to create support for [free-threading in Python][free-threading], it is still experimental.
67
Current standard library solutions such as [multiprocessing][multiprocessing-module] and [threading][threading-module] are difficult to implement with the current track tooling.
78
89
910
As a result, the concurrency requirement has been set aside for this exercise.
10-
Account operations are sequential on a single thread, and no concurrency or "race condition" tests are run.
11+
Account operations are sequential on a single thread, and no concurrency or "race condition" tests are run.
1112
12-
[GIL]: https://realpython.com/python-gil/
13+
14+
If you would like to experiment with free-threading or concurrency tests, we as that you do so [locally][testing-locally].
15+
For help with downloading and working on exercises locally, we recommend the [Exercism CLI][exercism-cli].
16+
17+
[exercism-cli]: https://exercism.org/cli-walkthrough
1318
[free-threading]: https://docs.python.org/3/howto/free-threading-python.html
14-
[threading-module]: https://docs.python.org/3/library/threading.html#module-threading
19+
[GIL]: https://realpython.com/python-gil/
1520
[multiprocessing-module]: https://docs.python.org/3/library/multiprocessing.html#sharing-state-between-processes
21+
[testing-locally]: https://exercism.org/docs/tracks/python/tests
22+
[threading-module]: https://docs.python.org/3/library/threading.html#module-threading
1623
~~~~
1724

1825
<br>
Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,14 @@
11
# Instructions append
22

3-
*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.
3+
~~~~exercism/note
4+
5+
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_).
6+
7+
This makes Python's [`set` type][python-sets] unsuited to this exercise, since it is inherently _unordered_.
8+
You should return a [`list`][python-list] of `list`s instead (_e.g. `[[a, b, c]]`_).
9+
You can generate the triplets themselves in whichever order you would like, as the enclosing `list`'s order will be ignored in the tests.
10+
11+
[math-sets]: https://en.wikipedia.org/wiki/Set_(mathematics)
12+
[python-sets]: https://docs.python.org/3/tutorial/datastructures.html#sets
13+
[python-list]: https://docs.python.org/3/tutorial/datastructures.html#more-on-lists
14+
~~~~
Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,11 @@
11
# Instructions append
22

3-
You can make the following assumptions about the inputs to the
3+
# Notes for this exercise on the Python track
4+
5+
You can make the following assumptions about the test inputs to the
46
`sum_of_multiples` function:
5-
* All input numbers are non-negative `int`s, i.e. natural numbers
6-
including zero.
7-
* A list of factors must be given, and its elements are unique
8-
and sorted in ascending order.
7+
8+
- All input numbers are **_non-negative `int`s_** (_i.e. natural numbers
9+
including zero_).
10+
- A `list` of factors must be given, and its elements are unique
11+
and sorted in ascending order.

0 commit comments

Comments
 (0)