gwc-dcmb / curriculum-notebooks Goto Github PK
View Code? Open in Web Editor NEWJupyter notebooks for teaching Python for Data Science. Used by our Girls Who Code Club & Summer Experience.
License: Other
Jupyter notebooks for teaching Python for Data Science. Used by our Girls Who Code Club & Summer Experience.
License: Other
This is related to your JOSE submission.
One of my review checkboxes asks whether the your version matches v0.1.0. I see v0.1.1 as of June 18.
In a text cell we state that dictionaries are unordered, but that is no longer true as of Python 3.6.
Lesson 8 contains a "note to editor" about is
. For an upcoming iteration my suggestion would be to remove it here. A typical use is in tests for None
, which you do not seem to cover. In the subsequent lesson 09 it might be good to mention that we neither use is
nor ==
with Boolean values (but just the value itself instead of == True
; or not
for == False
).
Needed for club by September 30, 2024
Lesson still includes is
and is not
; gives syntax warning now and explaining this would be a more involved lesson
Files:
Lessons/_Keys/KEY_LessonXX_Topic.ipynb
)
Lessons/LessonXX_Topic.ipynb
)
Practices/_Keys/KEY_PracticeXX_Topic.ipynb
)
Practices/PracticeXX_Topic.ipynb
)
In lesson 16, you show iloc[99:105]
with the comment 100 through 105
. In lesson 17, iloc[5:11]
with 5 through 10
. I suggest to use a consistent numbering. Personally, I prefer the latter variant (maybe with a reminder that counting starts at 0).
I did not attempt to spot other locations. Similarly to issue #14, notebooks do not contain source code, making it hard to search through code on my filesystem...
This is related to your JOSE submission.
Your license mentions "The above copyright notice", which is not expressed clearly. I was expecting to see something like this: "Copyright "
In Lesson 21, there are references to rank 1 and rank 2. Since students haven't taken linear algebra yet, we might want to change this to refer to one dimensional and two dimensional data instead?
This is related to your JOSE submission.
One of my review checkboxes asks for community guidelines. Do they exist? Some projects have a file CONTRIBUTING...
The Boston dataset referenced in practice notebook 21 is no longer available for download--we should choose a new dataset and re-write this practice notebook, referencing the concepts used in the lesson.
This is related to your JOSE submission.
The paper is well written and addresses the questions relevant to JOSE. I've got some comments/questions:
At the end of the summary you write that anyone can contribute. I suggest to emphasize that you describe Open Educational Resources (OER) under free and open licenses. Actually, I wonder about the videos. They do not indicate license information, do they? Are they OER too? Are they only available on Youtube or also elsewhere for download and reuse?
Section "Collaborative Curriculum Development"
I suggest to phrase learning objectives with action verbs (what will students be able to do?). The first objective is too vague in this regard, while the other two are fine.
You write about "paired programming". I suggest "pair programming".
One of our facilitators noted this year that the Spotify dataset is a big difficult to understand especially for beginners, so we should either document what the values mean for this dataset or remove it from our capstone project dataset folder.
Needed for club by Sept 30, 2024
The practice file suggests using "arrange" instead of "arange" --> need to fix typo
Files:
Lessons/_Keys/KEY_LessonXX_Topic.ipynb
)
Lessons/LessonXX_Topic.ipynb
)
Practices/_Keys/KEY_PracticeXX_Topic.ipynb
)
Practices/PracticeXX_Topic.ipynb
)
Jupyter cannot convert Key notebooks that contain images (e.g. Lesson 09 & 24). When running jupyter nbconvert
in the build action, it fails with this error:
LaTeX Warning: File `https://raw.githubusercontent.com/GWC-DCMB/curriculum-note
books/main/Figures/IfElifElseDiagram.png' not found on input line [598](https://github.com/GWC-DCMB/curriculum-notebooks/actions/runs/3686899000/jobs/6239765330#step:7:599).
! Unable to load picture or PDF file 'https://raw.githubusercontent.com/GWC-DCM
B/curriculum-notebooks/main/Figures/IfElifElseDiagram.png'.
<to be read again>
}
l.598 ...books/main/Figures/IfElifElseDiagram.png}
?
! Emergency stop.
<to be read again>
}
l.598 ...books/main/Figures/IfElifElseDiagram.png}
Using local file paths instead of https links doesn't resolve the problem. It appears to be a known issue: jupyter/nbconvert#1079
Since we're mostly teaching in a flipped classroom style rather than with live-coding these days, let's temporarily stop trying to keep the PDFs updated until nbconvert resolves the issue.
Lists are not properly converted to PDF, e.g., the list of data types at the end of this file: https://github.com/GWC-DCMB/curriculum-notebooks/blob/main/Lessons/_Keys/pdf/KEY_Lesson03_Variables_Types.pdf
Images do not appear to be embedded, e.g., the if-elif-else diagram is not contained in that file: https://github.com/GWC-DCMB/curriculum-notebooks/blob/main/Lessons/_Keys/pdf/KEY_Lesson09_Conditionals.pdf
This is related to your JOSE submission.
I did not use Google Colab before. After reading the paper I thought that the Python source code for the notebooks was available on GitHub (so that I could retain/reuse/revise/remix/redistribute it as OER, without Google Colab). I may be missing something fundamental here, but this does not seem to be the case. E.g., how would I create a PR to address issue #14 and change &
into and
?
Besides, if I open a workbook via a link from the README, pressing "play" asks me to log in to Google. Is that a hard prerequisite to use the notebooks? If so, please document this.
Moving this part from #16: "In the subsequent lesson 09 it might be good to mention that we neither use is
nor ==
with Boolean values (but just the value itself instead of == True
; or not
for == False
)."
We could do something like this toward the end:
my_list = [0, 1, 2, 3, 4, 5, 6, 7]
is_short = len(my_list) < 10
is_medium = not is_short and len(my_list) < 20
if is_short:
print("This list is short!")
elif is_medium:
print("This list is a medium length.")
else:
print("This list is on the long side!")
Files:
Lessons/_Keys/KEY_LessonXX_Topic.ipynb
)
Lessons/LessonXX_Topic.ipynb
)
Practices/_Keys/KEY_PracticeXX_Topic.ipynb
)
Practices/PracticeXX_Topic.ipynb
)
This is in relation to the JOSE review.
"Community guidelines" ask for guidelines on seeking support. While you address contributing and reporting issues excellently, I do not find seeking support explicitly mentioned. I would personally assume that I can try opening an issue asking for support on something, but my assumption may be wrong and in any case, it might be a good idea to also briefly mention in your README whether and how you can ask for support on the lesson material.
The PDF for Lesson09_Conditionals contains condition len(my_list) >= 10 & len(my_list) < 15
. I do not see this in the source notebook. Instead I see colab_type
, id
and outputId
. Should this be changed?
Besides, the &
should be and
.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.