barbagroup / essential_skills_rrc Goto Github PK

We need a references section for the whole course. Include the Scopatz & Huff book, the Dr Chuck online courses, Software Carpentry.

The numba session has missing figures in the notebooks. We need to updates them, following @gforsyth repo numba_tutorial_quick

Thanks @nripoll for pointing this out!

a quick intro notebook to introduce students to the components of the jupyter notebook.

cell creation & deletion
code / markdown / mathjax
command mode
editing mode

Not a lot of slides, but "waypoint" slides for quickly throwing up on a screen the commands we've learned so far.

• move copa_america goal text file somewhere besides the root of the repo
• delete resources folder that's at root
• use resources folder to host copa_america goals and other script
• find a place for the uber data set to be hosted, so students can download it
• complete wget instructions in git.md#L38

In https://github.com/barbagroup/essential_skills_RRC/blob/master/docs/resources.md it suggests ShareLaTeX: they've now merged with overleaf.com

Similar to #1, create "waypoint" slides for various points in the tutorial that show what we've learned so far

There's some demonstration of it in the uber example, but I forgot to actually explain it in the text earlier on.

• Figure out if we're in a lab or people are bringing laptops (lab)
  • What copy/paste commands are available (Is it Ctrl+Shift+V or Shift-Insert?)
• Instructions for signing up for GitHub w/education pack
• Figure out if we will have a screen/ projector to show what we are doing so students can follow us.

put it in notebooks and use relative path to load it in all notebooks

0. On section "Navigation" in the ls --help subsection, the display of the helper has some coloring problems. It colors in pink things in between ' ' but it takes the ' that appears in "don't" as a starting ', causing chunks of text in pink that shouldn't be pink.

1. In subsection "Creating, editing, removing files" of Unix section, cells that display folders have a coloring problem. For example in cells like:

Desktop/    Downloads/  Pictures/  TODO        Videos/   
Documents/  Music/      Public/    Templates/  newfile

The words Downloads, TODO, Videos, Music and Templates appear in green, and for some reason Public is in bold.

2. The command ls always appears in bold while the other commands don't (in "File creation and editing" section).

3. Remove TODO exercises at the end of "File creation and editing" section.

4. In Ipython section, some cells have coloring on the In[ ] and Out[ ] and others don't. I think the difference is if there is or not a space in between the word In/Out and the brackets. Besides when they are colored sometimes appear in blue and others in black.

5. In Ipython section comments in the code cells have some coloring style that it's inconsistent. Check subsection "list", code comment on Output of In[41] .

• Complete wget part to get the python script.
• The script words_count.py in the repo is not the first one, it's the second version. Shall we "checked it out" to the original version?

1. In the section "piping" subsection "sort", we start using wget without introducing it.
2. The section "man and less" doesn't introduce man and less. However we use them in the "Uber exercise" section

We should change the scientific stack notebooks to use the long form of the keyword arguments for educational purposes. e.g. linestyle instead of ls

Thanks @labarba for pointing this out

Since machines are preconfigured, should we show them how to actually set things up for themselves?

Also talk about conda-forge and using environments

Small detail: In the md version of the notebooks, the links that are in the license's header are not display properly.

There's always going to be a bunch of stuff we don't have time to cover, but we can provide a list of helpful services / links.

e.g.

• For publishing datasets publicly and getting an associated DOI, use Zenodo

what else?

In the notebook "The python scientific stack" we load a video from youtube. When we convert to markdown this video doesn't appear (what makes sense because it's a markdown file) but there are 2 cells with html code. Not sure what is the best solution for the webpage.