Sync secret-handshake docs with problem-specifications

exercises/practice/secret-handshake/.docs/instructions.md

@@ -1,29 +1,47 @@
 # Instructions
 
-> There are 10 types of people in the world: Those who understand
-> binary, and those who don't.
+Your task is to convert a number between 1 and 31 to a sequence of actions in the secret handshake.
 
-You and your fellow cohort of those in the "know" when it comes to
-binary decide to come up with a secret "handshake".
-
-```text
-1 = wink
-10 = double blink
-100 = close your eyes
-1000 = jump
+The sequence of actions is chosen by looking at the rightmost five digits of the number once it's been converted to binary.
+Start at the right-most digit and move left.
 
+The actions for each number place are:
 
+```plaintext
+00001 = wink
+00010 = double blink
+00100 = close your eyes
+01000 = jump
 10000 = Reverse the order of the operations in the secret handshake.
 ```
 
-Given a decimal number, convert it to the appropriate sequence of events for a secret handshake.
+Let's use the number `9` as an example:
+
+- 9 in binary is `1001`.
+- The digit that is farthest to the right is 1, so the first action is `wink`.
+- Going left, the next digit is 0, so there is no double-blink.
+- Going left again, the next digit is 0, so you leave your eyes open.
+- Going left again, the next digit is 1, so you jump.
+
+That was the last digit, so the final code is:
+
+```plaintext
+wink, jump
+```
+
+Given the number 26, which is `11010` in binary, we get the following actions:
 
-Here's a couple of examples:
+- double blink
+- jump
+- reverse actions
 
-Given the input 3, the function would return the array
-["wink", "double blink"] because 3 is 11 in binary.
+The secret handshake for 26 is therefore:
+
+```plaintext
+jump, double blink
+```
 
-Given the input 19, the function would return the array
-["double blink", "wink"] because 19 is 10011 in binary.
-Notice that the addition of 16 (10000 in binary)
-has caused the array to be reversed.
+~~~~exercism/note
+If you aren't sure what binary is or how it works, check out [this binary tutorial][intro-to-binary].
+[intro-to-binary]: https://medium.com/basecs/bits-bytes-building-with-binary-13cb4289aafa
+~~~~

exercises/practice/secret-handshake/.docs/introduction.md

@@ -0,0 +1,7 @@
+# Introduction
+
+You are starting a secret coding club with some friends and friends-of-friends.
+Not everyone knows each other, so you and your friends have decided to create a secret handshake that you can use to recognize that someone is a member.
+You don't want anyone who isn't in the know to be able to crack the code.
+
+You've designed the code so that one person says a number between 1 and 31, and the other person turns it into a series of actions.