{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# How to get feedback from students on your notebooks?\n",
    "\n",
    "We provide a generic survey that you can embed into your notebooks to **collect anonymous feedback** from those who use your notebooks.  \n",
    "The survey is designed to be short and easy to fill out, with three questions (both in English and French) focusing on helpfulness, usability and a free text field for comments. You can see the survey form below.  \n",
    "The survey will automatically collect data for you. We then process the data and provide you with a summary of the feedback regularly.  \n",
    "\n",
    "## How to use it?\n",
    "\n",
    "**Step 1:** Add a cell to your notebook and copy the following piece of code in it:\n",
    "\n",
    " ```python\n",
    "from IPython.display import IFrame\n",
    "IFrame('https://www.surveymonkey.com/r/NOTOSURVEY?notebook_set=COURSENAME&notebook_id=NOTEBOOKNAME', 600, 800)\n",
    "```\n",
    "\n",
    "**Step 2:** In the code, replace the two following elements (attention: DO NOT USE SPACES, use dash or underscore to replace spaces):\n",
    "* `COURSENAME`: replace by name of the project or course, e.g. `MecaDRIL` or `PHYS-101`\n",
    "* `NOTEBOOKNAME`: replace by the name or code of the notebook in the course, e.g. `01-Logan` \n",
    "\n",
    "\n",
    "Example of complete URL:  \n",
    "`https://www.surveymonkey.com/r/NOTOSURVEY?notebook_set=MecaDRIL&notebook_id=01-Logan`\n",
    "\n",
    "**Optional:** It can be useful to add one line of text above the code cell with the survey to indicate to your students that you would appreciate their feedback on your notebook.  \n",
    "You could use something like:\n",
    "\n",
    "```\n",
    "Did you like this Notebook? Why don't you give us some feedback using the completely anonymous form below (just execute the cell to see it)? Thank you!\n",
    "```\n",
    "\n",
    "## Demo\n",
    "\n",
    "Execute the cell below to see the survey:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "from IPython.display import IFrame\n",
    "IFrame('https://www.surveymonkey.com/r/NOTOSURVEY?notebook_set=noto-poc-notebooks&notebook_id=survey-monkey-demo', 600, 900)"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.8"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}