diff --git a/exercises/practice/acronym/.docs/instructions.append.md b/exercises/practice/acronym/.docs/instructions.append.md index 1c1c2660..bcfe14f2 100644 --- a/exercises/practice/acronym/.docs/instructions.append.md +++ b/exercises/practice/acronym/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Try to find a way to split up a String and then iterate over the resulting sections to output a result. \ No newline at end of file +## Implementation + +Try to find a way to split up a String and then iterate over the resulting sections to output a result. diff --git a/exercises/practice/all-your-base/.docs/instructions.append.md b/exercises/practice/all-your-base/.docs/instructions.append.md index 4951d357..61f1db31 100644 --- a/exercises/practice/all-your-base/.docs/instructions.append.md +++ b/exercises/practice/all-your-base/.docs/instructions.append.md @@ -1 +1,5 @@ -You may want to explore Number class and its methods in Pharo, and how to add to OrderedCollection in different order. \ No newline at end of file +# Instructions append + +## Hint + +You may want to explore Number class and its methods in Pharo, and how to add to OrderedCollection in different order. diff --git a/exercises/practice/allergies/.docs/instructions.append.md b/exercises/practice/allergies/.docs/instructions.append.md index 9617b024..85e7efd6 100644 --- a/exercises/practice/allergies/.docs/instructions.append.md +++ b/exercises/practice/allergies/.docs/instructions.append.md @@ -1,5 +1,7 @@ # Instructions append +## Implementation + Notice how each of the items is a power of 2, a property that you should be able to leverage. Check out the 'bit manipulation' protocol of class Integer. diff --git a/exercises/practice/anagram/.docs/instructions.append.md b/exercises/practice/anagram/.docs/instructions.append.md index 29a3cb70..3c0cbff8 100644 --- a/exercises/practice/anagram/.docs/instructions.append.md +++ b/exercises/practice/anagram/.docs/instructions.append.md @@ -1,5 +1,7 @@ # Instructions append +## Implementation + You must return the anagrams in the same order as they are listed in the candidate words. As with Isogram, it's worth browsing what data types are already available in the system. diff --git a/exercises/practice/armstrong-numbers/.docs/instructions.append.md b/exercises/practice/armstrong-numbers/.docs/instructions.append.md index cda5c4f1..e92a1c9e 100644 --- a/exercises/practice/armstrong-numbers/.docs/instructions.append.md +++ b/exercises/practice/armstrong-numbers/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Browse the class Integer for some inspiration \ No newline at end of file +## Hint + +Browse the class Integer for some inspiration. diff --git a/exercises/practice/atbash-cipher/.docs/instructions.append.md b/exercises/practice/atbash-cipher/.docs/instructions.append.md index ac98bfe6..1731f6c5 100644 --- a/exercises/practice/atbash-cipher/.docs/instructions.append.md +++ b/exercises/practice/atbash-cipher/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -This is a fun little exercise, just follow the tests. \ No newline at end of file +## Note + +This is a fun little exercise, just follow the tests. diff --git a/exercises/practice/binary-search-tree/.docs/instructions.append.md b/exercises/practice/binary-search-tree/.docs/instructions.append.md index ec2c0ce1..071b7430 100644 --- a/exercises/practice/binary-search-tree/.docs/instructions.append.md +++ b/exercises/practice/binary-search-tree/.docs/instructions.append.md @@ -1,3 +1,6 @@ # Instructions append -You may want to use objects of the same class that represent tree and subtrees (nodes). Try to use recursion method for adding and sorting nodes. \ No newline at end of file +## Note + +You may want to use objects of the same class that represent tree and subtrees (nodes). +Try to use recursion method for adding and sorting nodes. diff --git a/exercises/practice/binary/.docs/instructions.append.md b/exercises/practice/binary/.docs/instructions.append.md index 1567b17b..9e3c94c3 100644 --- a/exercises/practice/binary/.docs/instructions.append.md +++ b/exercises/practice/binary/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -The ^ operation in Pharo is expressed as the descriptive keyword message #raisedTo: \ No newline at end of file +## Note + +The ^ operation in Pharo is expressed as the descriptive keyword message #raisedTo: diff --git a/exercises/practice/bowling/.docs/instructions.append.md b/exercises/practice/bowling/.docs/instructions.append.md index ac43cc72..748f2caa 100644 --- a/exercises/practice/bowling/.docs/instructions.append.md +++ b/exercises/practice/bowling/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -You will need to store some game state. \ No newline at end of file +## Implementation + +You will need to store some game state. diff --git a/exercises/practice/circular-buffer/.docs/instructions.append.md b/exercises/practice/circular-buffer/.docs/instructions.append.md index f27238b8..ba038d3f 100644 --- a/exercises/practice/circular-buffer/.docs/instructions.append.md +++ b/exercises/practice/circular-buffer/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -For error cases during operations, see Error class hiearchy (class side) to find out how to signal exception with given message. \ No newline at end of file +## Implementation + +For error cases during operations, see Error class hiearchy (class side) to find out how to signal exception with given message. diff --git a/exercises/practice/clock/.docs/instructions.append.md b/exercises/practice/clock/.docs/instructions.append.md index 76490dbf..63b9a647 100644 --- a/exercises/practice/clock/.docs/instructions.append.md +++ b/exercises/practice/clock/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Try and encapsulate your implementation \ No newline at end of file +## Implementation + +Try and encapsulate your implementation. diff --git a/exercises/practice/collatz-conjecture/.docs/instructions.append.md b/exercises/practice/collatz-conjecture/.docs/instructions.append.md index 0397cad1..5c08a220 100644 --- a/exercises/practice/collatz-conjecture/.docs/instructions.append.md +++ b/exercises/practice/collatz-conjecture/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -This is nicely suited for recursion \ No newline at end of file +## Note + +This is nicely suited for recursion. diff --git a/exercises/practice/diamond/.docs/instructions.append.md b/exercises/practice/diamond/.docs/instructions.append.md index f024409a..8e1627e3 100644 --- a/exercises/practice/diamond/.docs/instructions.append.md +++ b/exercises/practice/diamond/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Extract clear, single purpose methods to keep your solution understandable \ No newline at end of file +## Note + +Extract clear, single purpose methods to keep your solution understandable. diff --git a/exercises/practice/die/.docs/instructions.append.md b/exercises/practice/die/.docs/instructions.append.md index a311980a..699bcdd2 100644 --- a/exercises/practice/die/.docs/instructions.append.md +++ b/exercises/practice/die/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append +## Note + This exercise has been sourced from the book: Learning Object-Oriented Programming, Design and TDD with Pharo available at http://books.pharo.org. Chapter 12: Crafting a simple embedded DSL with Pharo. diff --git a/exercises/practice/etl/.docs/instructions.append.md b/exercises/practice/etl/.docs/instructions.append.md index f43000c7..aa1b1ebe 100644 --- a/exercises/practice/etl/.docs/instructions.append.md +++ b/exercises/practice/etl/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -While readability is preferred over efficiency, there is a solution that avoids multiple input looksups when solving this. \ No newline at end of file +## Note + +While readability is preferred over efficiency, there is a solution that avoids multiple input looksups when solving this. diff --git a/exercises/practice/flatten-array/.docs/instructions.append.md b/exercises/practice/flatten-array/.docs/instructions.append.md index b202acdd..bb073a09 100644 --- a/exercises/practice/flatten-array/.docs/instructions.append.md +++ b/exercises/practice/flatten-array/.docs/instructions.append.md @@ -1,3 +1,6 @@ # Instructions append -Without using the built-in flattening method, you can derive your own, but you will need to differentiate between what is a collection and what is not. Alternatively, if you decide to use the built-in flattening methods, you will need to create a new Stream type to override incorrect behaviour. \ No newline at end of file +## Note + +Without using the built-in flattening method, you can derive your own, but you will need to differentiate between what is a collection and what is not. +Alternatively, if you decide to use the built-in flattening methods, you will need to create a new Stream type to override incorrect behaviour. diff --git a/exercises/practice/forth/.docs/instructions.append.md b/exercises/practice/forth/.docs/instructions.append.md index 0ebff545..d4722af3 100644 --- a/exercises/practice/forth/.docs/instructions.append.md +++ b/exercises/practice/forth/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -It might take several classes and/or instances to model this \ No newline at end of file +## Note + +It might take several classes and/or instances to model this. diff --git a/exercises/practice/gigasecond/.docs/instructions.append.md b/exercises/practice/gigasecond/.docs/instructions.append.md index 1160dfd7..1a72a4e3 100644 --- a/exercises/practice/gigasecond/.docs/instructions.append.md +++ b/exercises/practice/gigasecond/.docs/instructions.append.md @@ -1 +1,6 @@ -The Kernel-Chronology package has many useful date and time related classes and protocols. The Date and Time class have useful printing methods which you can use to create your own ISO8601 date and time representation. \ No newline at end of file +# Instructions append + +## Note + +The Kernel-Chronology package has many useful date and time related classes and protocols. +The Date and Time class have useful printing methods which you can use to create your own ISO8601 date and time representation. diff --git a/exercises/practice/grade-school/.docs/instructions.append.md b/exercises/practice/grade-school/.docs/instructions.append.md index b9a5cf17..1a15365f 100644 --- a/exercises/practice/grade-school/.docs/instructions.append.md +++ b/exercises/practice/grade-school/.docs/instructions.append.md @@ -1,5 +1,7 @@ # Instructions append +## Note + It isn't strictly necessary to model students as a separate object, you can use a convenient internal data structure as the requirements are quite simple (and as long as it doesn't leak out into the results). ~~~~exercism/note diff --git a/exercises/practice/grains/.docs/instructions.append.md b/exercises/practice/grains/.docs/instructions.append.md index efac3337..2ee3f431 100644 --- a/exercises/practice/grains/.docs/instructions.append.md +++ b/exercises/practice/grains/.docs/instructions.append.md @@ -1,3 +1,9 @@ # Instructions append -These kinds of problems (where an answer is dependent on a previous) one are often called recursion. There are different ways to code for recursion, it might be worth reasearching if you are not familiar with this. Pharo is well optimised for recursion, and it is a commonly used pattern. Note: in the original problem specification, the grainsCalculator is called via #square, however we have renamed this method #atSquare: which is a more Smalltalk like name, that better describes that you are asking for an answer "at a square". \ No newline at end of file +## Note + +These kinds of problems (where an answer is dependent on a previous) one are often called recursion. +There are different ways to code for recursion, it might be worth reasearching if you are not familiar with this. +Pharo is well optimised for recursion, and it is a commonly used pattern. + +Note: in the original problem specification, the grainsCalculator is called via #square, however we have renamed this method #atSquare: which is a more Smalltalk like name, that better describes that you are asking for an answer "at a square". diff --git a/exercises/practice/hamming/.docs/instructions.append.md b/exercises/practice/hamming/.docs/instructions.append.md index 3c13066a..57a05d07 100644 --- a/exercises/practice/hamming/.docs/instructions.append.md +++ b/exercises/practice/hamming/.docs/instructions.append.md @@ -1,3 +1,6 @@ # Instructions append -In Smalltalk, exceptions are instances of subclasses of Exception. While you can create your own for your domain, if you browse this hierarchy you can choose something appropriate to simplify your solution. \ No newline at end of file +## Note + +In Smalltalk, exceptions are instances of subclasses of Exception. +While you can create your own for your domain, if you browse this hierarchy you can choose something appropriate to simplify your solution. diff --git a/exercises/practice/hello-world/.docs/instructions.append.md b/exercises/practice/hello-world/.docs/instructions.append.md index 025c6ee6..ae242055 100644 --- a/exercises/practice/hello-world/.docs/instructions.append.md +++ b/exercises/practice/hello-world/.docs/instructions.append.md @@ -1,3 +1,15 @@ # Instructions append -If you are editting this file in a text editor and not in Pharo - please review the [Getting Started](https://exercism.io/tracks/pharo/installation) section. While you can use a text editor, the Pharo IDE is partly what makes the language so special. In Pharo you can run code (including tests) with broken methods and missing classes. When the VM encounters broken code, it raises a debugger which lets you explore the problem a little better. You then have the option to press the Create button to add a missing class or method, as well as correct any code that causes an error. When you do so, the debugger will backup and let you resume execution with your new changes. Try doing this with your HelloWorld example, by simply running any one of the unit test methods. \ No newline at end of file +## Note + +If you are editting this file in a text editor and not in Pharo - please review the [Getting Started](https://www.exercism.org/tracks/pharo/installation) section. + +While you can use a text editor, the Pharo IDE is partly what makes the language so special. + +In Pharo you can run code (including tests) with broken methods and missing classes. +When the VM encounters broken code, it raises a debugger which lets you explore the problem a little better. + +You then have the option to press the Create button to add a missing class or method, as well as correct any code that causes an error. +When you do so, the debugger will backup and let you resume execution with your new changes. + +Try doing this with your HelloWorld example, by simply running any one of the unit test methods. diff --git a/exercises/practice/high-scores/.docs/instructions.append.md b/exercises/practice/high-scores/.docs/instructions.append.md index d0ea8978..b3f8609a 100644 --- a/exercises/practice/high-scores/.docs/instructions.append.md +++ b/exercises/practice/high-scores/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -This is a nice exercise to just test drive (TDD), and let each test guide your solution \ No newline at end of file +## Note + +This is a nice exercise to just test drive (TDD), and let each test guide your solution. diff --git a/exercises/practice/isbn-verifier/.docs/instructions.append.md b/exercises/practice/isbn-verifier/.docs/instructions.append.md index 461253de..3c4c7759 100644 --- a/exercises/practice/isbn-verifier/.docs/instructions.append.md +++ b/exercises/practice/isbn-verifier/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Use the lessons from previous exercises, try and keep your methods small \ No newline at end of file +## Note + +Use the lessons from previous exercises, try and keep your methods small. diff --git a/exercises/practice/isogram/.docs/instructions.append.md b/exercises/practice/isogram/.docs/instructions.append.md index 5984179a..a5feda77 100644 --- a/exercises/practice/isogram/.docs/instructions.append.md +++ b/exercises/practice/isogram/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -There is a range of interesting data types in Pharo, it's worth taking the time to browse the hierarchy of class Collection and reading some of the class comments and running some of the examples. \ No newline at end of file +## Note + +There is a range of interesting data types in Pharo, it's worth taking the time to browse the hierarchy of class Collection and reading some of the class comments and running some of the examples. diff --git a/exercises/practice/leap/.docs/instructions.append.md b/exercises/practice/leap/.docs/instructions.append.md index bd3a5d2d..8bc3f4d9 100644 --- a/exercises/practice/leap/.docs/instructions.append.md +++ b/exercises/practice/leap/.docs/instructions.append.md @@ -1,3 +1,16 @@ # Instructions append -The tests for this exercise (and future exercises), are prefix numbered like 'test00_'. This is not a normal convention in Pharo, however to ease the study of the language it is useful to present tests in a deterministic order. For this exercise, study the 'arithmetic' method category for class Number, as well as how boolean operators are also defined as messages. Notice how "and:" and "or:" are implented in the classes True and False. You can use the context menu item "senders of..." to view how other parts of Pharo use these operators. You may also find something useful trying... `World > Tools > Finder > Examples > 20 . 4 . true`
which is asking Pharo which operations between the first and second elements result in the third.
[View demo][demo] [demo]: https://github.com/exercism/pharo-smalltalk/raw/master/docs/images/Hint-Finder-Leap.gif \ No newline at end of file +## Note + +The tests for this exercise (and future exercises), are prefix numbered like 'test00_'. +his is not a normal convention in Pharo, however to ease the study of the language it is useful to present tests in a deterministic order. + +For this exercise, study the 'arithmetic' method category for class Number, as well as how boolean operators are also defined as messages. +Notice how "and:" and "or:" are implented in the classes True and False. +You can use the context menu item "senders of..." to view how other parts of Pharo use these operators. + +You may also find something useful trying... `World > Tools > Finder > Examples > 20 . 4 . true` which is asking Pharo which operations between the first and second elements result in the third. + +[View demo][demo] + +[demo]: https://github.com/exercism/pharo-smalltalk/raw/master/docs/images/Hint-Finder-Leap.gif diff --git a/exercises/practice/luhn/.docs/instructions.append.md b/exercises/practice/luhn/.docs/instructions.append.md index ca2169e4..3e458fc0 100644 --- a/exercises/practice/luhn/.docs/instructions.append.md +++ b/exercises/practice/luhn/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Read the instructions carefully, if you skim you might miss some important details about direction. \ No newline at end of file +## Note + +Read the instructions carefully, if you skim you might miss some important details about direction. diff --git a/exercises/practice/matching-brackets/.docs/instructions.append.md b/exercises/practice/matching-brackets/.docs/instructions.append.md index 63b288da..bb9365b6 100644 --- a/exercises/practice/matching-brackets/.docs/instructions.append.md +++ b/exercises/practice/matching-brackets/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Saving state in a useful data type can help here. \ No newline at end of file +## Note + +Saving state in a useful data type can help here. diff --git a/exercises/practice/matrix/.docs/instructions.append.md b/exercises/practice/matrix/.docs/instructions.append.md index 5234f415..1e8a0218 100644 --- a/exercises/practice/matrix/.docs/instructions.append.md +++ b/exercises/practice/matrix/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Try using the Finder - Examples searcher, to see if there is a useful method for parsing. \ No newline at end of file +## Note + +Try using the Finder - Examples searcher, to see if there is a useful method for parsing. diff --git a/exercises/practice/minesweeper/.docs/instructions.append.md b/exercises/practice/minesweeper/.docs/instructions.append.md index cb5a8b84..b2bd18f9 100644 --- a/exercises/practice/minesweeper/.docs/instructions.append.md +++ b/exercises/practice/minesweeper/.docs/instructions.append.md @@ -1,3 +1,7 @@ # Instructions append -x,y locations are often represented as a Point, which then leads to some useful point functions that can help with this. Alternatively, representing this as a 2D Array can also be useful. Either way, defining some descriptive extension methods that can make your solution much more readable and elegant. \ No newline at end of file +## Note + +x,y locations are often represented as a Point, which then leads to some useful point functions that can help with this. +Alternatively, representing this as a 2D Array can also be useful. +Either way, defining some descriptive extension methods that can make your solution much more readable and elegant. diff --git a/exercises/practice/ocr-numbers/.docs/instructions.append.md b/exercises/practice/ocr-numbers/.docs/instructions.append.md index 1850d103..48172238 100644 --- a/exercises/practice/ocr-numbers/.docs/instructions.append.md +++ b/exercises/practice/ocr-numbers/.docs/instructions.append.md @@ -1,5 +1,9 @@ +# Instructions append + +## Note + The following text could be parsed from this comment and used to recognize characters: ' _ _ _ _ _ _ _ _ ' ' | _| _||_||_ |_ ||_||_|| |' ' ||_ _| | _||_| ||_| _||_|' -' ' \ No newline at end of file +' ' diff --git a/exercises/practice/pangram/.docs/instructions.append.md b/exercises/practice/pangram/.docs/instructions.append.md index 2ead609f..d383f5be 100644 --- a/exercises/practice/pangram/.docs/instructions.append.md +++ b/exercises/practice/pangram/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -It pays off to carefully read the exercise description as this can simplify your solution and make it quite compact. \ No newline at end of file +## Note + +It pays off to carefully read the exercise description as this can simplify your solution and make it quite compact. diff --git a/exercises/practice/proverb/.docs/instructions.append.md b/exercises/practice/proverb/.docs/instructions.append.md index c3e1cb1a..a4e78aad 100644 --- a/exercises/practice/proverb/.docs/instructions.append.md +++ b/exercises/practice/proverb/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -This one can be quite simple if you look at ways to iterate over the list of inputs. \ No newline at end of file +## Note + +This one can be quite simple if you look at ways to iterate over the list of inputs. diff --git a/exercises/practice/raindrops/.docs/instructions.append.md b/exercises/practice/raindrops/.docs/instructions.append.md index bcf8e6df..c8f991a7 100644 --- a/exercises/practice/raindrops/.docs/instructions.append.md +++ b/exercises/practice/raindrops/.docs/instructions.append.md @@ -1,3 +1,7 @@ # Instructions append -Try to focus on using Test Driven Development for this exercise. Run the tests, one by one and try to solve the problem incrementally as it unfolds. When everything passes, see if you can refactor it to make it less repetitive. \ No newline at end of file +## Note + +Try to focus on using Test Driven Development for this exercise. +Run the tests, one by one and try to solve the problem incrementally as it unfolds. +When everything passes, see if you can refactor it to make it less repetitive. diff --git a/exercises/practice/rectangles/.docs/instructions.append.md b/exercises/practice/rectangles/.docs/instructions.append.md index 2ea320fc..7faeaed8 100644 --- a/exercises/practice/rectangles/.docs/instructions.append.md +++ b/exercises/practice/rectangles/.docs/instructions.append.md @@ -1 +1,5 @@ -You may be able to use a brute force strategy to solve this one. \ No newline at end of file +# Instructions append + +## Note + +You may be able to use a brute force strategy to solve this one. diff --git a/exercises/practice/resistor-color-duo/.docs/instructions.append.md b/exercises/practice/resistor-color-duo/.docs/instructions.append.md index d10b52db..01f492bb 100644 --- a/exercises/practice/resistor-color-duo/.docs/instructions.append.md +++ b/exercises/practice/resistor-color-duo/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -You will need some form of lookup table of colours to calculate the value. You don't necessarily have to use a Dictionary to do this. \ No newline at end of file +## Note + +You will need some form of lookup table of colours to calculate the value. You don't necessarily have to use a Dictionary to do this. diff --git a/exercises/practice/robot-simulator/.docs/instructions.append.md b/exercises/practice/robot-simulator/.docs/instructions.append.md index dc2c21e1..d05fa0d5 100644 --- a/exercises/practice/robot-simulator/.docs/instructions.append.md +++ b/exercises/practice/robot-simulator/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -It's useful to consider having a seperate Robot oject and even write some of your own tests for it, possibly using TDD to drive out useful behaviour. \ No newline at end of file +## Note + +It's useful to consider having a seperate Robot oject and even write some of your own tests for it, possibly using TDD to drive out useful behaviour. diff --git a/exercises/practice/roman-numerals/.docs/instructions.append.md b/exercises/practice/roman-numerals/.docs/instructions.append.md index c88da3b2..9412e23e 100644 --- a/exercises/practice/roman-numerals/.docs/instructions.append.md +++ b/exercises/practice/roman-numerals/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -This exercise uses techniques from several of the others, but also requires some conditional looping. \ No newline at end of file +## Note + +This exercise uses techniques from several of the others, but also requires some conditional looping. diff --git a/exercises/practice/secret-handshake/.docs/instructions.append.md b/exercises/practice/secret-handshake/.docs/instructions.append.md index 6e95c256..93b8e4b9 100644 --- a/exercises/practice/secret-handshake/.docs/instructions.append.md +++ b/exercises/practice/secret-handshake/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -The Integer class has a bit manipulation protocol which may be useful. \ No newline at end of file +## Note + +The Integer class has a bit manipulation protocol which may be useful. diff --git a/exercises/practice/sieve/.docs/instructions.append.md b/exercises/practice/sieve/.docs/instructions.append.md index 3f4c41df..9ac6e29b 100644 --- a/exercises/practice/sieve/.docs/instructions.append.md +++ b/exercises/practice/sieve/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -To make your solution readable, try using the refactoring tools to extract any meaningful sub-operation(s), and don't worry about using well named temporary variables. \ No newline at end of file +## Note + +To make your solution readable, try using the refactoring tools to extract any meaningful sub-operation(s), and don't worry about using well named temporary variables. diff --git a/exercises/practice/simple-cipher/.docs/instructions.append.md b/exercises/practice/simple-cipher/.docs/instructions.append.md index 73191dc6..56644519 100644 --- a/exercises/practice/simple-cipher/.docs/instructions.append.md +++ b/exercises/practice/simple-cipher/.docs/instructions.append.md @@ -1,3 +1,5 @@ # Instructions append -Try using arithmetic operations like modulo to wrap indexes, when exceeded. Character, String classes are your friends too. \ No newline at end of file +## Note + +Try using arithmetic operations like modulo to wrap indexes, when exceeded. Character, String classes are your friends too. diff --git a/exercises/practice/space-age/.docs/instructions.append.md b/exercises/practice/space-age/.docs/instructions.append.md index 9e34c920..72509e1c 100644 --- a/exercises/practice/space-age/.docs/instructions.append.md +++ b/exercises/practice/space-age/.docs/instructions.append.md @@ -1,3 +1,8 @@ # Instructions append -You might find Pharo dictionaries useful in completing this exercise. Pharo has several ways to construct dictionaries, including `Dictionary new: at:put:` and a literal syntax using `Association`s. An `Association` looks like `key -> value` and can be turned into a dictionary like this: `{ 'key' -> 'value' } asDictionary`. Remember that in Smalltalk, all infix operators are right-associative and that you can browse any of the classes mentioned above live. \ No newline at end of file +## Note + +You might find Pharo dictionaries useful in completing this exercise. +Pharo has several ways to construct dictionaries, including `Dictionary new: at:put:` and a literal syntax using `Association`s. +An `Association` looks like `key -> value` and can be turned into a dictionary like this: `{ 'key' -> 'value' } asDictionary`. +Remember that in Smalltalk, all infix operators are right-associative and that you can browse any of the classes mentioned above live. diff --git a/exercises/practice/sum-of-multiples/.docs/instructions.append.md b/exercises/practice/sum-of-multiples/.docs/instructions.append.md index 2107804f..7b7a777a 100644 --- a/exercises/practice/sum-of-multiples/.docs/instructions.append.md +++ b/exercises/practice/sum-of-multiples/.docs/instructions.append.md @@ -1,3 +1,9 @@ # Instructions append -The trick to this exercise understanding how to iterate accross a range of numbers as well as check a Collection for any multiples that are divisible by a number. Try using the Spotter to look up potential classes and browse the categories of methods in those classes. Also remember that the Pharo environment is extensively cross referenced. You can right click on any class or method and browse "references" to a class (to see how it might be created), as well as "senders" of a method (to see how it might be used). \ No newline at end of file +## Note + +The trick to this exercise understanding how to iterate accross a range of numbers as well as check a Collection for any multiples that are divisible by a number. +Try using the Spotter to look up potential classes and browse the categories of methods in those classes. + +Also remember that the Pharo environment is extensively cross referenced. +You can right click on any class or method and browse "references" to a class (to see how it might be created), as well as "senders" of a method (to see how it might be used). diff --git a/exercises/practice/tournament/.docs/instructions.append.md b/exercises/practice/tournament/.docs/instructions.append.md index 225805b2..fcd32879 100644 --- a/exercises/practice/tournament/.docs/instructions.append.md +++ b/exercises/practice/tournament/.docs/instructions.append.md @@ -1,3 +1,8 @@ # Instructions append -Build up this exercise piece by piece, and don't be afraid to split out any useful concepts into a new class. Previous exercises should give the foundation for a neat solution. It might also be helpfulnto review chapters on Object Oriented thinking, for example [Inside Smalltalk - Chapter 1](http://sdmeta.gforge.inria.fr/FreeBooks/InsideST/InsideSmalltalk.pdf) or [Smalltalk by Example - Chapter 9](http://sdmeta.gforge.inria.fr/FreeBooks/ByExample/11%20-%20Chapter%209%20-%20Object-Oriente.pdf) \ No newline at end of file +## Note + +Build up this exercise piece by piece, and don't be afraid to split out any useful concepts into a new class. +Previous exercises should give the foundation for a neat solution. + +It might also be helpful to review chapters on Object Oriented thinking, for example [Inside Smalltalk - Chapter 1](http://sdmeta.gforge.inria.fr/FreeBooks/InsideST/InsideSmalltalk.pdf) or [Smalltalk by Example - Chapter 9](http://sdmeta.gforge.inria.fr/FreeBooks/ByExample/11%20-%20Chapter%209%20-%20Object-Oriente.pdf) diff --git a/exercises/practice/twelve-days/.docs/instructions.append.md b/exercises/practice/twelve-days/.docs/instructions.append.md index 579018c7..3241bb18 100644 --- a/exercises/practice/twelve-days/.docs/instructions.append.md +++ b/exercises/practice/twelve-days/.docs/instructions.append.md @@ -1,3 +1,22 @@ # Instructions append -Its handy to have a list of the verses: ^ #( 'a Partridge in a Pear Tree' 'two Turtle Doves' 'three French Hens' 'four Calling Birds' 'five Gold Rings' 'six Geese-a-Laying' 'seven Swans-a-Swimming' 'eight Maids-a-Milking' 'nine Ladies Dancing' 'ten Lords-a-Leaping' 'eleven Pipers Piping' 'twelve Drummers Drumming' ) \ No newline at end of file +## Note + +Its handy to have a list of the verses: + +```text +#( +'a Partridge in a Pear Tree' +'two Turtle Doves' +'three French Hens' +'four Calling Birds' +'five Gold Rings' +'six Geese-a-Laying' +'seven Swans-a-Swimming' +'eight Maids-a-Milking' +'nine Ladies Dancing' +'ten Lords-a-Leaping' +'eleven Pipers Piping' +'twelve Drummers Drumming' +) +``` diff --git a/exercises/practice/two-fer/.docs/instructions.append.md b/exercises/practice/two-fer/.docs/instructions.append.md index 6ab8700d..62c3f5dd 100644 --- a/exercises/practice/two-fer/.docs/instructions.append.md +++ b/exercises/practice/two-fer/.docs/instructions.append.md @@ -1,3 +1,10 @@ # Instructions append -In Pharo, classes are objects that can have instance and class methods, however unlike HelloWorld the tests for TwoFer have been written to call instance methods. Typically class methods are used for constructing new objects (like a contructor in other languages). While referring to methods, its useful to know that a method which has no parameters, is called a unary method, and a method taking multiple parameters, each deliniated by a word ending with a ':', is called a keyword method. There is also a third type of method, binary, which takes only 1 parameter and uses a symbol(s) for a name (typically a mathematical one like: +, -, & etc). \ No newline at end of file +## Implementation + +In Pharo, classes are objects that can have instance and class methods, however unlike HelloWorld the tests for TwoFer have been written to call instance methods. +Typically class methods are used for constructing new objects (like a contructor in other languages). + +While referring to methods, its useful to know that a method which has no parameters, is called a unary method, and a method taking multiple parameters, each deliniated by a word ending with a ':', is called a keyword method. + +There is also a third type of method, binary, which takes only 1 parameter and uses a symbol(s) for a name (typically a mathematical one like: +, -, & etc). diff --git a/exercises/practice/word-count/.docs/instructions.append.md b/exercises/practice/word-count/.docs/instructions.append.md index e56aeeee..ab7e02ba 100644 --- a/exercises/practice/word-count/.docs/instructions.append.md +++ b/exercises/practice/word-count/.docs/instructions.append.md @@ -1,3 +1,6 @@ # Instructions append -There are several ways to approach this, study class String carefully and take it step by step. You might change approach mid way through if the solution becomes more complicated. \ No newline at end of file +## Implementation + +There are several ways to approach this, study class String carefully and take it step by step. +You might change approach mid way through if the solution becomes more complicated.