Improve JEP-3 content and formatting (#143)

* Fix typos in JEP-3

* Improve JEP-3 formatting

* Refactor presentation of the JEP-3 nested function example

Author: gibson042

jep-003-functions.md

@@ -196,79 +196,64 @@ Below is a worked example.  Given:
 
 Evaluating `abs(foo)` works as follows:
 
-
 1. Evaluate the input argument against the current data:
+   ```
+   search(foo, {"foo": -1, "bar": 2"}) -> -1
+   ```
 
-```
-search(foo, {"foo": -11, "bar": 2"}) -> -1
-```
-
-
-2. Validate the type of the resolved argument.  In this case
-`-1` is of type `number` so it passes the type check.
-
+2. Validate the type of the resolved argument.
+   In this case `-1` is of type `number` so it passes the type check.
 
 3. Call the function with the resolved argument:
+   ```
+   abs(-1) -> 1
+   ```
 
-```
-abs(-1) -> 1
-```
-
+4. The value of `1` is the resolved value of the function expression `abs(foo)`.
 
-4. The value of `1` is the resolved value of the function expression
-
-    `abs(foo)`.
 
 Below is the same steps for evaluating `abs(bar)`:
 
-
 1. Evaluate the input argument against the current data:
+   ```
+   search(bar, {"foo": -1, "bar": 2"}) -> "2"
+   ```
 
-```
-search(foo, {"foo": -1, "bar": 2"}) -> "2"
-```
-
+2. Validate the type of the resolved argument.
+   In this case `"2"` is of type `string` so immediately indicate that an
+   `invalid-type` error occurred.
 
-2. Validate the type of the resolved argument.  In this case
-`"2` is of type `string` so the immediate indicate that
-an `invalid-type` error occurred.
 
 As a final example, here is the steps for evaluating `abs(to_number(bar))`:
 
-
 1. Evaluate the input argument against the current data:
-
-```
-search(to_number(bar), {"foo": -1, "bar": "2"})
-```
-
-
-2. In order to evaluate the above expression, we need to evaluate
-`to_number(bar)`:
-
-```
-search(bar, {"foo": -1, "bar": "2"}) -> "2"
-# Validate "2" passes the type check for to_number, which it does.
-to_number("2") -> 2
-```
-
-
-3. Now we can evaluate the original expression:
-
-```
-search(to_number(bar), {"foo": -1, "bar": "2"}) -> 2
-```
-
-
-4. Call the function with the final resolved value:
-
-```
-abs(2) -> 2
-```
-
+   ```
+   search(to_number(bar), {"foo": -1, "bar": "2"})
+   ```
+   This requires following the same process for `to_number(bar)`:
+   1. Evaluate the input argument against the current data:
+      ```
+      search(bar, {"foo": -1, "bar": "2"}) -> "2"
+      ```
+   2. Validate the type of the resolved argument.
+      In this case `"2"` is of type `string` so it passes the type check.
+   3. Call the function with the resolved argument:
+      ```
+      to_number("2") -> 2
+      ```
+   4. The value of `2` is the resolved value of the function expression
+      `to_number(bar)`.
+
+2. Validate the type of the resolved argument.
+   In this case `2` is of type `number` so it passes the type check.
+
+3. Call the function with the final resolved argument:
+   ```
+   abs(2) -> 2
+   ```
 
 5. The value of `2` is the resolved value of the function expression
-`abs(to_number(bar))`.
+   `abs(to_number(bar))`.
 
 #### Examples