Added more context to the range builtin

Added comments to the examples
Added explanations of the parameters for range

Author: johntheholman

docs/builtin/range.md

@@ -16,8 +16,37 @@ Python range() built-in function
   </base-disclaimer-content>
 </base-disclaimer>
 
+# Basics
+
+The `range` type is commonly used in `for` loops to loop a specific number of times. `range` takes in three parameters, `start`, `stop` and `step`. Each parameter must be intergers (either built-in int or any object that implements the __index__() special method).
+
+If there is only one parameter, it represents the `stop` parameter. If the `step` parameter is omitted at all, it will default to `1`. If the `start` parameter is omitted, it will default to `0`.
+
+Ranges do support negative indices, but these are interpreted as indexing from the end of the sequence determined by the positive indices.
+
+***The advantage of the range type over a regular list or tuple is that a range object will always take the same (small) amount of memory, no matter the size of the range it represents
+
+## Input Parameters:
+
+Ranges implement all of the common sequence operations except concatenation and repetition (due to the fact that range objects can only represent sequences that follow a strict pattern and repetition and concatenation will usually violate that pattern).
+
+`start`:
+- The value of the start parameter
+- If not supplied, parameter will default to 0
+- Parameter value is _inclusive_
+
+`stop`
+- The value of the stop parameter
+- The only parameter that is required
+- Parameter value is _exclusive_
+
+`step`
+- The value of the step parameter
+- If not supplied, parameter will default to 1
+
 ## Examples
 
+Range with only `stop` parameter specified
 ```python
 >>> for i in range(5):
 ...     print(i)
@@ -28,6 +57,7 @@ Python range() built-in function
 # 4
 ```
 
+Range with both `start` and `stop` parameters
 ```python
 >>> for i in range(1,8):
 ...     print(i)
@@ -40,6 +70,7 @@ Python range() built-in function
 # 7
 ```
 
+Range with all parameters specified
 ```python
 >>> for i in range(0,30,5):
 ...     print(i)
@@ -51,6 +82,7 @@ Python range() built-in function
 # 25
 ```
 
+Range with all parameters, where the `stop` parameter is not divisible by the `step` parameter
 ```python
 >>> for i in range(0,10,3):
 ...     print(i)
@@ -60,6 +92,7 @@ Python range() built-in function
 # 9
 ```
 
+Range with all parameters, where the `stop` and `step` parameters are negative
 ```python
 >>> for i in range(0,-6,-1):
 ...     print(i)
@@ -71,17 +104,7 @@ Python range() built-in function
 # -5
 ```
 
-```python
->>> for i in range(0,-6,-1):
-...     print(i)
-# 0
-# -1
-# -2
-# -3
-# -4
-# -5
-```
-
+Two examples where the `stop` parameter is set to 0
 ```python
 >>> for i in range(0):
 ...     print(i)
@@ -93,7 +116,3 @@ Python range() built-in function
 ...     print(i)
 # 
 ```
-
-<!-- remove this tag to start editing this page -->
-<empty-section />
-<!-- remove this tag to start editing this page -->