Setup Instructions

[kmpaul]

We need a setup instructions document. It should probably be placed on the Nikola site:

/site/pages/spring2020/instructions.md

...or *.rst or similar.

[kmpaul]

Probably need instructions for the Beginner tutorial separately from the Intermediate tutorial.

• The Beginner tutorial instructions will probably be minimal, namely just make sure people can install miniconda and (possibly) git. (I say "possibly" for git because you can actually install git with conda.)

• The Intermediate tutorial probably requires miniconda instructions as well as a tutorial conda environment file to install the necessary dependencies. Maybe we make this fairly simple for the tutorial (i.e., not a lot of labextensions), and then provide a more complex set of instructions for "production" environments... maybe even have a short instruction during the tutorial on installing the "production" environment.

[jukent]

Similar to https://github.com/NCAR/ncar-python-tutorial/blob/master/README.md but only for personal computer (for beginner track day 1), tell people to go to miniconda download page, not having an environment for them (don't want to hide this process).

Is this simple enough that we just direct people here https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html

Do we need tests? It's pretty simple if anything is broken.

Instructions for people with an old version of conda, how to update.

step 1
Check conda version

step 2
2a, if old, update
2b if really old, delete and reinstall might be easier)

• check env list to see if they need to save old environments
  2c if not found, install

step 3
relaunch terminal

step 4
be in base environment
check conda version again

[jukent]

Here is the link to the blog, where the instructions will be hosted
https://ncar.github.io/ncar-python-tutorial/

[jukent]

Also have them check git -version

Everyone on Windows need to have a terminal, probably do already to access Cheyenne.

[jukent]

Also include getting Github account if they don't already.

[jukent]

I will have these written up in the self-paced script.