Merge pull request #868 from josemunozc/move-comment-description-to-lesson-1

moved comment description to first lesson

Author: noatgnu

_episodes/01-intro.md

@@ -14,7 +14,9 @@ keypoints:
 - "Use `variable = value` to assign a value to a variable in order to record it in memory."
 - "Variables are created on demand whenever a value is assigned to them."
 - "Use `print(something)` to display the value of `something`."
+- "Use `# some kind of explanation` to add comments to programs."
 - "Built-in functions are always available to use."
+
 ---
 
 ## Variables
@@ -209,8 +211,12 @@ weight in kilograms is now: 65.0
 > ~~~
 > {: .output}
 >
-> ![Value of 65.0 with weight_kg label stuck on it, and value of 143.0 with weight_lb label
-stuck on it](../fig/python-sticky-note-variables-02.svg)
+> Everything in a line of code following the '#' symbol is a
+> [comment]({{ page.root }}/reference/#comment) that is ignored by Python.
+> Comments allow programmers to leave explanatory notes for other
+> programmers or their future selves.
+> 
+> ![Value of 65.0 with weight_kg label stuck on it, and value of 143.0 with weight_lb label stuck on it](../fig/python-sticky-note-variables-02.svg)
 >
 > Similar to above, the expression `2.2 * weight_kg` is evaluated to `143.0`,
 > and then this value is assigned to the variable `weight_lb` (i.e. the sticky

_episodes/02-numpy.md

@@ -17,7 +17,6 @@ keypoints:
 - "Use `array[x, y]` to select a single element from a 2D array."
 - "Array indices start at 0, not 1."
 - "Use `low:high` to specify a `slice` that includes the indices from `low` to `high-1`."
-- "Use `# some kind of explanation` to add comments to programs."
 - "Use `numpy.mean(array)`, `numpy.max(array)`, and `numpy.min(array)` to calculate simple statistics."
 - "Use `numpy.mean(array, axis=0)` or `numpy.mean(array, axis=1)` to calculate statistics across the specified axis."
 ---
@@ -410,11 +409,6 @@ maximum inflammation for patient 0: 18.0
 ~~~
 {: .output}
 
-Everything in a line of code following the '#' symbol is a
-[comment]({{ page.root }}/reference.html#comment) that is ignored by Python.
-Comments allow programmers to leave explanatory notes for other
-programmers or their future selves.
-
 We don't actually need to store the row in a variable of its own.
 Instead, we can combine the selection and the function call: