Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Notebooks with blanks #309
With the Python workshop, typing everything takes too much time. Participants are concentrated to copy what we type, and they do not listen to explanations. With these notebooks, I want them to focus on the new thing they are learning. For example, if I want to teach the for loop, all print statements are already there.
Exercises are no longer at the end of the chapter. I tried to apply the principle of "doing an exercise after learning up to 7 new things". This is why exercises are distributed in the appropriate sections of each chapter.
In the same "notebooks" folder, we can find notebooks with blanks (0x-yyy.ipynb) and their solution (soln-0x-yyy.ipynb).
Now, regarding _episodes/03-lists.md, I have improved the primes/odds examples. I have also fixed a print statement.
EDIT: I would like to use these notebooks for the event of September 8 in Montreal (Canada). Thanks!
Thanks for preparing all these notebooks: they are very useful resource! We have discussed before whether to include notebooks in the lesson, but the biggest problem with this is keeping them in sync with the main lesson (as changes are continuously made), so in general we prefer them to be separate. It would be useful to have a way to link to them. @tbekolay is there some place to put supplementary materials? We can create a final 11-resources.md file which contains useful links?
I think adding something to the Extras menu at the top would be good; I believe that any valid markdown file we place in the
In my humble opinion...
I believe notebooks should come with all the necessary data samples. Proposed notebooks are in the "notebooks" folder and are consistently using the "../data/" prefix for input files. Participants are then learning how to separate their code from their data.
That being said, having to download and extract one archive file for the data and one extra archive file for notebooks, some participants may find a way to put the data in the wrong parent folder, which will lead to extra problems to debug in the classroom. IMO, we do not have time to lose on this kind of problem. We better keep data samples together with notebooks, either in python-novice-inflammation or in a new project (inflammation-material, for example).
Synchronizing the online material with notebooks should not be a big problem as all instructors should always review and test, before any event, what they are about to teach because all lessons are continuously getting updated. And if there is any important discrepancy between the online material and notebooks, any certified instructor that wants to use those notebooks should already have the knowledge to do corrections through GitHub.
Finally, the Python lesson has already too much material to fit in 3.5 hours, even if using notebooks. Instructors are already skipping subsections and exercises in the very updated online lesson. Having notebooks that are slightly outdated should not be a big problem if subsections and exercises are identified/labelled such that instructors and participants can follow.