Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Convert backtick (`) admonition fences to tildes (~) #795

Merged
merged 1 commit into from
Oct 6, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -48,12 +48,12 @@ what iterations it will ask for.
In this case it will keep taking iterations until the third element of the tuple is `true`, which is not set until
creating the tuple for the iteration _after_ the first element number has been calculated down to 0.

```exercism/caution
~~~~exercism/caution
We might be tempted to use a tuple of only two elements and `takeWhile(tup => tup._1 > 0)`,
but this will omit the last iteration where the tuple generated is `(0,153.0)`.
The tuple is generated, but since it has a first element of `0`, it is not _taken_.
This is why we need the `Boolean` flag to stop _after_ we've taken the tuple with a first element of `0`.
```
~~~~

As of this writing, Scala 3 is not yet supported on the Scala track. With Scala 3 we could destructure the tuple in the lambda like so:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,10 +37,10 @@ Then a [nested function][nested-function] (also called a [closure][closure]) is
The first argument is for the number that is being calculated.
The second number is for totaling the results of the calculations.

```exercism/note
~~~~exercism/note
Although the number of digits is not passed into the inner function, the inner function still has access to it.
It is said that the value for the number of digits is _captured_ by the inner function.
```
~~~~

The [nested function][nested-function] is annotated with the [`@tailrec`][tailrec-annotation] annotation to verify that the function can be compiled
with [tail call optimization][tail-opt].
Expand Down
4 changes: 2 additions & 2 deletions exercises/practice/bob/.approaches/answers-vector/content.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,10 @@ The correct answer is selected from the array by using the score as the array in
The `String` [`trim()`][trim] method is applied to the input to eliminate any whitespace at either end of the input.
If the string has no characters left, it returns the response for saying nothing.

```exercism/caution
~~~~exercism/caution
Note that a `null` `String` would be different from a `String` of all whitespace.
A `null` `String` would throw a `NullPointerException` if `trim()` were applied to it.
```
~~~~

The first half of setting `isShout` uses the [`exists`][exists] and [`isLetter`][isletter] methods to look for
at least one English alphabetic character.
Expand Down
4 changes: 2 additions & 2 deletions exercises/practice/bob/.approaches/if-expressions/content.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,10 @@ As soon as the right condition is found, the correct response is returned.
The `String` [`trim()`][trim] method is applied to the input to eliminate any whitespace at either end of the input.
If the string has no characters left, it returns the response for saying nothing.

```exercism/caution
~~~~exercism/caution
Note that a `null` `String` would be different from a `String` of all whitespace.
A `null` `String` would throw a `NullPointerException` if `trim()` were applied to it.
```
~~~~

The first half of setting `isShout` uses the [`exists`][exists] and [`isLetter`][isletter] methods to look for
at least one English alphabetic character.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,10 @@ the `isQuestion` and `isShout` values.
The `String` [`trim()`][trim] method is applied to the input to eliminate any whitespace at either end of the input.
If the string has no characters left, it returns the response for saying nothing.

```exercism/caution
~~~~exercism/caution
Note that a `null` `String` would be different from a `String` of all whitespace.
A `null` `String` would throw a `NullPointerException` if `trim()` were applied to it.
```
~~~~

The first half of setting `isShout` uses the [`exists`][exists] and [`isLetter`][isletter] methods to look for
at least one English alphabetic character.
Expand Down
4 changes: 2 additions & 2 deletions exercises/practice/gigasecond/.docs/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,12 @@ Then we can use metric system prefixes for writing large numbers of seconds in m
- Perhaps you and your family would travel to somewhere exotic for two megaseconds (that's two million seconds).
- And if you and your spouse were married for _a thousand million_ seconds, you would celebrate your one gigasecond anniversary.

```exercism/note
~~~~exercism/note
If we ever colonize Mars or some other planet, measuring time is going to get even messier.
If someone says "year" do they mean a year on Earth or a year on Mars?

The idea for this exercise came from the science fiction novel ["A Deepness in the Sky"][vinge-novel] by author Vernor Vinge.
In it the author uses the metric system as the basis for time measurements.

[vinge-novel]: https://www.tor.com/2017/08/03/science-fiction-with-something-for-everyone-a-deepness-in-the-sky-by-vernor-vinge/
```
~~~~
4 changes: 2 additions & 2 deletions exercises/practice/linked-list/.docs/instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Sometimes a station gets closed down, and in that case the station needs to be r

The size of a route is measured not by how far the train travels, but by how many stations it stops at.

```exercism/note
~~~~exercism/note
The linked list is a fundamental data structure in computer science, often used in the implementation of other data structures.
As the name suggests, it is a list of nodes that are linked together.
It is a list of "nodes", where each node links to its neighbor or neighbors.
Expand All @@ -23,4 +23,4 @@ In a **doubly linked list** each node links to both the node that comes before,
If you want to dig deeper into linked lists, check out [this article][intro-linked-list] that explains it using nice drawings.

[intro-linked-list]: https://medium.com/basecs/whats-a-linked-list-anyway-part-1-d8b7e6508b9d
```
~~~~
Original file line number Diff line number Diff line change
Expand Up @@ -37,15 +37,15 @@ as is if it is already empty.
The `isPaired()` method starts by calling the [`foldLeft()`][foldleft] method on the input `String`.
It is initialized with an empty `List` for the "stack" and `true` for a validity flag, both wrapped in a [tuple][tuple].

```exercism/note
~~~~exercism/note
Note that the [immutable `Stack`](https://www.scala-lang.org/api/2.12.17/scala/collection/immutable/Stack.html)
exists only for historical reason and as an analogue of mutable stacks.
Instead of an immutable stack you can just use a list.

The [mutable `Stack`](https://www.scala-lang.org/api/2.12.17/scala/collection/mutable/Stack.html) was deprecated since version 2.12.0.
`Stack` is an inelegant and potentially poorly-performing wrapper around List.
Use a List assigned to a var instead.
```
~~~~

The tuple and each character from the input is passed into the [lambda][lambda].
A [match][match] is used to destructure the tuple and uses the [`contains()`][set-contains] method
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,15 +42,15 @@ as is if it is already empty.
The `isPaired()` method returns the result of calling the private recursive method, to which it passes the input `String`.
and an empty `List` for the "stack".

```exercism/note
~~~~exercism/note
Note that the [immutable `Stack`](https://www.scala-lang.org/api/2.12.17/scala/collection/immutable/Stack.html)
exists only for historical reason and as an analogue of mutable stacks.
Instead of an immutable stack you can just use a list.

The [mutable `Stack`](https://www.scala-lang.org/api/2.12.17/scala/collection/mutable/Stack.html) was deprecated since version 2.12.0.
`Stack` is an inelegant and potentially poorly-performing wrapper around List.
Use a List assigned to a var instead.
```
~~~~

The recursive method is annotated with the [`@tailrec`][tailrec-annotation] annotation to verify that the method can be compiled
with [tail call optimization][tail-opt].
Expand Down
4 changes: 2 additions & 2 deletions exercises/practice/pangram/.docs/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@ To give a comprehensive sense of the font, the random sentences should use **all
They're running a competition to get suggestions for sentences that they can use.
You're in charge of checking the submissions to see if they are valid.

```exercism/note
~~~~exercism/note
Pangram comes from Greek, παν γράμμα, pan gramma, which means "every letter".

The best known English pangram is:

> The quick brown fox jumps over the lazy dog.
```
~~~~
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ object ProteinTranslation {
This approach starts by calling the [`grouped()`][grouped] method on the input `String`.
It will take a sequence of `Char`s up to the amount passed in.

```exercism/caution
~~~~exercism/caution
The `grouped()` treats a `String` as a plain sequence of `Char` code units and makes no attempt to keep surrogate pairs or codepoint sequences together.
The user is responsible for making sure such cases are handled correctly.
Failing to do so may result in an invalid Unicode `String`.
The `grouped()` method works here because all of the characters are [ASCII](https://www.asciitable.com/).
```
~~~~

If the remaining number of `Chars`s is less than the argument, `grouped()` will return those,
and will be an empty `Iterator` if no `Char`s are left.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,12 +65,12 @@ If the protein is for a `STOP` codon, the `match` returns the `Sequence` of prot
Otherwise, the method calls itself, using the [`drop()`][drop] method to pass in all but the first `3` `Char`s of the input `String`,
and passing in the existing `Sequence` of proteins with the protein added to the end of it with the [`:+`][append-operator] operator.

```exercism/caution
~~~~exercism/caution
The `take()` and `drop()` methods treat a string as a plain sequence of Char code units and makes no attempt to keep surrogate pairs or codepoint sequences together.
The user is responsible for making sure such cases are handled correctly.
Failing to do so may result in an invalid Unicode string.
The `take()` and `drop()` methods work here because all of the characters are [ASCII](https://www.asciitable.com/).
```
~~~~

[sequence]: https://www.geeksforgeeks.org/scala-sequence/
[match]: https://docs.scala-lang.org/tour/pattern-matching.html
Expand Down