Improve docs for ocr-numbers

Author: mk-mxp

exercises/practice/ocr-numbers/.docs/instructions.md

@@ -1,9 +1,8 @@
 # Instructions
 
-Given a 3 x 4 grid of pipes, underscores, and spaces, determine which number is
-represented, or whether it is garbled.
+Given a 3 x 4 grid of pipes, underscores, and spaces, determine which number is represented, or whether it is garbled.
 
-# Step One
+## Step One
 
 To begin with, convert a simple binary font to a string containing 0 or 1.
 
@@ -31,19 +30,19 @@ If the input is the correct size, but not recognizable, your program should retu
 
 If the input is the incorrect size, your program should return an error.
 
-# Step Two
+## Step Two
 
 Update your program to recognize multi-character binary strings, replacing garbled numbers with ?
 
-# Step Three
+## Step Three
 
 Update your program to recognize all numbers 0 through 9, both individually and as part of a larger string.
 
 ```text
- _ 
+ _
  _|
-|_ 
-   
+|_
+
 ```
 
 Is converted to "2"
@@ -57,23 +56,24 @@ Is converted to "2"
 
 Is converted to "1234567890"
 
-# Step Four
+## Step Four
 
-Update your program to handle multiple numbers, one per line. When converting several lines, join the lines with commas.
+Update your program to handle multiple numbers, one per line.
+When converting several lines, join the lines with commas.
 
 ```text
-    _  _ 
+    _  _
   | _| _|
   ||_  _|
-         
-    _  _ 
-|_||_ |_ 
+
+    _  _
+|_||_ |_
   | _||_|
-         
- _  _  _ 
+
+ _  _  _
   ||_||_|
   ||_| _|
-         
+
 ```
 
-Is converted to "123,456,789"
+Is converted to "123,456,789".

exercises/practice/ocr-numbers/.docs/introduction.md

@@ -0,0 +1,6 @@
+# Introduction
+
+Your best friend Marta recently landed their dream job working with a local history museum's collections.
+Knowing of your interests in programming, they confide in you about an issue at work for an upcoming exhibit on computing history.
+A local university's math department had donated several boxes of historical printouts, but given the poor condition of the documents, the decision has been made to digitize the text.
+However, the university's old printer had some quirks in how text was represented, and your friend could use your help to extract the data successfully.