modified help email + added Piazza.com exercise to 000

Author: giumas

000_Welcome_on_Board.ipynb

@@ -84,22 +84,6 @@
     "An `i` within a yellow circle indicates **supplemental information**. Thus, you may decide to skip these parts at a first read. "
    ]
   },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "In case that you have questions and comments about the notebooks: "
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/help.png\">\n",
-    "\n",
-    "A red megaphone at the top-right corner of each notebook provides a link to [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home). "
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -331,7 +315,7 @@
    "source": [
     "The following cell is a **Code** cell. You can recognize a **Code** cell since it has a `In [ ]` to the far left. \n",
     "\n",
-    "This **Code** cell does the very basic task of printing a \"Hello Python\" text. The next notebooks will introduce the main concepts of programming with Python. At this time, you will learn to execute the code in a **Code** cell:\n",
+    "This **Code** cell does the very basic task of printing a `\"Hello Python\"` text. The next notebooks will introduce the main concepts of programming with Python. At this time, you will learn to execute the code in a **Code** cell:\n",
     "\n",
     "- Activate the following Code cell by clicking in it.\n",
     "- Click the <button class='btn btn-default btn-xs'><i class=\"icon-step-forward fa fa-step-forward\"></i></button> Run button in the Toolbar (or, alternatively, press `Shift+Enter`) like you did for the **Markdown** cell."
@@ -350,7 +334,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If you got a \"Hello Python\" text under the **Code** cell, *congratulations!* You have successfully executed the Python code."
+    "If you got a `Hello Python` text under the **Code** cell, *congratulations!* You have successfully executed the Python code."
    ]
   },
   {
@@ -516,7 +500,7 @@
    },
    "outputs": [],
    "source": [
-    "print('Python is easy to learn!')"
+    "print(\"Python is easy to learn!\")"
    ]
   },
   {
@@ -681,6 +665,77 @@
     "***"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Questions or Comments?"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "These notebooks have a virtual gathering place on [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home) where you can ask (but also answer!) questions to instructors and fellow students."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<a href=\"https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home\"><img src=\"images/000_200_piazza_com.png\" title=\"Open Piazza.com\" align=\"center\" width=\"60%\" alt=\"Piazza.com\\\"></a>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/help.png\">\n",
+    "\n",
+    "A red megaphone at the top-right corner of each notebook provides a link to [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home). "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you click on this [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home) link, you can register yourself as a student to access the virtual gathering place.\n",
+    "\n",
+    "Once registered, what about introducing yourself to the community?"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "solution2": "hidden",
+    "solution2_first": true
+   },
+   "source": [
+    "<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/test.png\">\n",
+    "\n",
+    "Add a note containing your self-introduction in the \"community\" folder on [Piazza.com](https://piazza.com/e-learning_python_for_ocean_mapping/summer2019/om000/home). The following image shows how to do it in eight steps. Feel free to customize the text in the note as you prefer!\n",
+    "<br><br>\n",
+    "![Seven steps for a self-introduction note](images/000_250_eight_steps.png)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "solution2": "hidden"
+   },
+   "source": [
+    "If you follow the eight steps, the result will be a note similar to the following one (but with your specific details):\n",
+    "\n",
+    "![Note example](images/000_280_note_example.png)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "***"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -715,7 +770,7 @@
    "source": [
     "<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
     "\n",
-    "*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
+    "*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
    ]
   },
   {

001_Variables_and_Types.ipynb

@@ -42,7 +42,7 @@
     "- The first character **cannot be a number** (Python generates a `SyntaxError`).\n",
     "- By convention (as defined in the [PEP8](https://www.python.org/dev/peps/pep-0008/) coding style):\n",
     "  - Variable names **start with a lower-case letter**. \n",
-    "  - The underscore character `_` is used in names composed of multiple words to separate them."
+    "  - The underscore character `_` is used in names composed of multiple words to separate them (this convention is called [**snake_case**](https://en.wikipedia.org/wiki/Snake_case))."
    ]
   },
   {
@@ -427,7 +427,23 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "- The `//` operator is used to calculate the quotient of an [Euclidean division](https://en.wikipedia.org/wiki/Euclidean_division), that is to divide two numbers and then round down the result to an integer. For examples:"
+    "- The `//` operator is used to calculate the quotient of an [Euclidean division](https://en.wikipedia.org/wiki/Euclidean_division), that is to divide two numbers and then round down the result to an integer. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img align=\"left\" width=\"6%\" style=\"padding-right:10px;\" src=\"images/info.png\">\n",
+    "\n",
+    "The `//` operator is also known as *floored division* and *integer division*."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The following example uses the `//` operator:"
    ]
   },
   {
@@ -1016,7 +1032,7 @@
    "source": [
     "<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
     "\n",
-    "*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
+    "*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
    ]
   },
   {

002_Lists_of_Variables.ipynb

@@ -93,7 +93,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "It is possible to create and populate a list simply by enclosing the values in **square** brackets, `[` and `]`:"
+    "It is possible to create and populate a list simply by enclosing the values in **square** brackets (i.e., `[` and `]`) and separating them using `,`:"
    ]
   },
   {
@@ -614,7 +614,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "For instance, the `remove()` method is used to remove a given element from a `list`. \n",
+    "For instance, the `remove()` method is used to remove the **first** element with a given value from a `list`. \n",
     "\n",
     "The code in the cell below displays two numbers: \n",
     "\n",
@@ -801,7 +801,7 @@
    "source": [
     "<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
     "\n",
-    "*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
+    "*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
    ]
   },
   {

003_Conditional_Execution.ipynb

@@ -356,6 +356,16 @@
     "Comments do not need to be long (actually, verbose comments should be avoided!). Comments should be used in combination with meaningful variable names to clarify your intentions."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "There is a component of **subjectivity** in deciding when a comment is required. However, there should be always a comment when one of the following two cases applies:\n",
+    "\n",
+    "* The code is **complicated** (also when the reasons behind your implementation are clear). \n",
+    "* The reasons behind your implementation might be **unclear** (even if the code is simple). "
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -795,7 +805,7 @@
    "source": [
     "<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
     "\n",
-    "*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
+    "*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
    ]
   },
   {

004_Loops.ipynb

@@ -447,7 +447,7 @@
    "source": [
     "<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
     "\n",
-    "*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
+    "*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
    ]
   },
   {

005_Write_Your_Own_Functions.ipynb

@@ -505,15 +505,15 @@
    "source": [
     "<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
     "\n",
-    "*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
+    "*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
     "<!--NAVIGATION-->\n",
-    "[< Loops](004_Loops.ipynb) | [Contents](index.ipynb) | [Dictionaries >](006_Dictionaries.ipynb)"
+    "[< Loops](004_Loops.ipynb) | [Contents](index.ipynb) | [Dictionaries and Metadata >](006_Dictionaries_and_Metadata.ipynb)"
    ]
   }
  ],

006_Dictionaries.ipynb renamed to 006_Dictionaries_and_Metadata.ipynb

@@ -210,7 +210,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## What is Metadata?"
+    "# What is Metadata?"
    ]
   },
   {
@@ -417,17 +417,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 28,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "The first name is: John\n"
-     ]
-    }
-   ],
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "metadata = dict()\n",
     "metadata[\"first_name\"] = \"John\"\n",
@@ -444,18 +436,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 29,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "The position is: 43.135555, -70.939534\n",
-      "Start time: 2019-02-22 12:32:40\n"
-     ]
-    }
-   ],
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "metadata = dict()\n",
     "metadata[\"latitude\"] = 43.135555\n",
@@ -475,17 +458,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 33,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "The first name is: John\n"
-     ]
-    }
-   ],
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "metadata = dict()\n",
     "metadata[\"first_name\"] = \"John\"\n",
@@ -495,18 +470,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 37,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "The position is: 43.135558, -70.939534\n",
-      "Start time: 2019-02-22 12:32:40\n"
-     ]
-    }
-   ],
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "metadata = dict()\n",
     "metadata[\"latitude\"] = 43.135558\n",
@@ -545,17 +511,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 41,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "The position is: 43.1356, -70.9395\n"
-     ]
-    }
-   ],
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "metadata = dict()\n",
     "metadata[\"latitude\"] = 43.135558\n",
@@ -600,7 +558,7 @@
    "source": [
     "<img align=\"left\" width=\"5%\" style=\"padding-right:10px;\" src=\"images/email.png\">\n",
     "\n",
-    "*For issues or suggestions related to this notebook, write to: gmasetti@ccom.unh.edu*"
+    "*For issues or suggestions related to this notebook, write to: epom@ccom.unh.edu*"
    ]
   },
   {