Module 1 Suggestions for Improvements

[yuliaUU]

I have not find any mistakes or typos in a slide decks. So there is no PR associated with this Module.

I would like to leave here some general comments on Module 1 for future improvements:

1. Videos:

• 1 Intro to DST: slide 4 BASH: in the description of what BASH is used for it says automation of task. And it says that what we will learn in this course. However, we don't teach them that

• 1 Intro to DST: slide 5 Git & GitHub: I would do a separate list for each. Cause students have reported in the past that they do not understand the difference between git and GitHub, I think having a separate list for each will help to reduce this confusion

• 1 Intro to DST: slide 7 Jupyter Lab and VS Code: we do not really touch on VS Code except of one module for resolving Git Conflicts- and it could be done in Jupyter lab. May be we omit VS Code from this course (or create extra module aimed for VS CODE)? I would also make a separate list for each tool just to point out that they are not the same

• 3 slide 7: I did not see any section in the modules where we teach them how to save layouts ( i may have missed it in Module 7)

• 5 slide 1: it is a bit of a Jump to topic, and was not clear "where" we ask effective questions or how it is related to the course

• 5 slide: would be best to show bad question examples from a StackOverflow  

  2. Slides:

• 1- slide 7: not sure about statement: "As a soft prerequisite for this course, we recommend you to already be familiar with using JupyterLab to edit Jupyter notebooks. " . Then why they learn markdown in this course if they already are familiar with it?

3. General for all slides

• For all slide decks: I think would be great to make 'edits' to slides by highlighting/circling things that are discussed, more images and diagrams needs to appear ( for instance when we describe a tool, to show an image how it looks). It will make videos more interactive: cause most of teh time students just see several bullet points for 2-3 minutes while a speaker describes the tool

[joelostblom]

Great, thank you @yuliaUU ! This is great for improving the course further in the future and also great that there are no mistakes in the slides that needs immediate fixing. A few comments:

May be we omit VS Code from this course (or create extra module aimed for VS CODE)?

Yes, I agree and think we could admit VS Code now that Git in jupyterlab does the branch visualization (or potentially add a full module on it if we want to expand the course)

I did not see any section in the modules where we teach them how to save layouts ( i may have missed it in Module 7)

Yes, I think module 7 does talk about how to lay out workspaces.

Then why they learn markdown in this course if they already are familiar with it?

They idea here is that they already have a very basic familiarity from the intro programming course and will build upon that in this course. To make sure everyone is on the same page, we also repeat a bit of intro e.g. for markdown. But maybe this can be made clearer.