Merge branch 'master' into dash-datashader

Author: YunkeXiao

apps/dash-opioid-epidemic/README.md

@@ -2,41 +2,37 @@
 
 Poison induced death data was downloaded from [CDC Wonder](dash_app_screencast.gif), using cause-of-death codes X40–X44 (unintentional), X60–X64 (suicide), X85 (homicide), or Y10–Y14 (undetermined intent).
 
-[View the Dash app](https://dash-playground.plotly.host/dash-opioid-epidemic/)
+[View the Dash app](https://dash-gallery.plotly.host/dash-opioid-epidemic/)
 
 ## Getting Started
 
 ### Running the app locally
-
-First create a virtual environment with conda or venv inside a temp folder, then activate it.
+We suggest you to create a separate virtual environment running Python 3 for this app, and install all of the required dependencies there. Run in Terminal/Command Prompt:
 
 ```
-virtualenv venv
+git clone https://github.com/plotly/dash-sample-apps
+cd dash-sample-apps/apps/dash-opioid-epidemic
+python3 -m virtualenv venv
+```
+In UNIX system: 
 
-# Windows
-venv\Scripts\activate
-# Or Linux
+```
 source venv/bin/activate
-
 ```
-
-Clone the git repo, then install the requirements with pip
+In Windows: 
 
 ```
-
-git clone https://github.com/plotly/dash-sample-apps
-cd dash-sample-apps/apps/dash-opioid-epidemic
-pip install -r requirements.txt
-
+venv\Scripts\activate
 ```
 
-Run the app
+To install all of the required packages to this environment, simply run:
 
+```
+pip install -r requirements.txt
 ```
 
-python app.py
+and all of the required `pip` packages, will be installed, and the app will be able to run.
 
-```
 
 ![plotly-dash-screencast](assets/app_screencast.gif)