troubleshooting.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "<a id='troubleshooting'></a>\n",
    "<div id=\"qe-notebook-header\" align=\"right\" style=\"text-align:right;\">\n",
    "        <a href=\"https://quantecon.org/\" title=\"quantecon.org\">\n",
    "                <img style=\"width:250px;display:inline;\" width=\"250px\" src=\"https://assets.quantecon.org/img/qe-menubar-logo.svg\" alt=\"QuantEcon\">\n",
    "        </a>\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Troubleshooting"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Contents\n",
    "\n",
    "- [Troubleshooting](#Troubleshooting)  \n",
    "  - [Fixing Your Local Environment](#Fixing-Your-Local-Environment)  \n",
    "  - [Reporting an Issue](#Reporting-an-Issue)  "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This page is for readers experiencing errors when running the code from the lectures."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Fixing Your Local Environment\n",
    "\n",
    "The basic assumption of the lectures is that code in a lecture should execute whenever\n",
    "\n",
    "1. it is executed in a Jupyter notebook and  \n",
    "1. the notebook is running on a machine with the latest version of Anaconda Python.  \n",
    "\n",
    "\n",
    "You have installed Anaconda, haven’t you, following the instructions in [this lecture](https://python.quantecon.org/getting_started.html)?\n",
    "\n",
    "Assuming that you have, the most common source of problems for our readers is that their Anaconda distribution is not up to date.\n",
    "\n",
    "[Here’s a useful article](https://www.anaconda.com/keeping-anaconda-date/)\n",
    "on how to update Anaconda.\n",
    "\n",
    "Another option is to simply remove Anaconda and reinstall.\n",
    "\n",
    "You also need to keep the external code libraries, such as [QuantEcon.py](https://quantecon.org/quantecon-py) up to date.\n",
    "\n",
    "For this task you can either\n",
    "\n",
    "- use pip install –upgrade quantecon on the command line, or  \n",
    "- execute !pip install –upgrade quantecon within a Jupyter notebook.  \n",
    "\n",
    "\n",
    "If your local environment is still not working you can do two things.\n",
    "\n",
    "First, you can use a remote machine instead, by clicking on the Launch Notebook icon available for each lecture\n",
    "\n",
    "<img src=\"https://s3-ap-southeast-2.amazonaws.com/python.quantecon.org/_static/lecture_specific/troubleshooting/launch.png\" style=\"\">\n",
    "\n",
    "Second, you can report an issue, so we can try to fix your local set up.\n",
    "\n",
    "We like getting feedback on the lectures so please don’t hesitate to get in\n",
    "touch."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Reporting an Issue\n",
    "\n",
    "One way to give feedback is to raise an issue through our [issue tracker](https://github.com/QuantEcon/lecture-source-py/issues).\n",
    "\n",
    "Please be as specific as possible.  Tell us where the problem is and as much\n",
    "detail about your local set up as you can provide.\n",
    "\n",
    "Another feedback option is to use our [discourse forum](https://discourse.quantecon.org/).\n",
    "\n",
    "Finally, you can provide direct feedback to [contact@quantecon.org](mailto:contact@quantecon.org)"
   ]
  }
 ],
 "metadata": {
  "date": 1584334758.9779892,
  "filename": "troubleshooting.rst",
  "kernelspec": {
   "display_name": "Python",
   "language": "python3",
   "name": "python3"
  },
  "title": "Troubleshooting"
 },
 "nbformat": 4,
 "nbformat_minor": 2
}