New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Notebooks with blanks #309

Open
wants to merge 47 commits into
base: gh-pages
from

Conversation

Projects
None yet
4 participants
@plstonge

plstonge commented Sep 5, 2016

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!

@valentina-s

This comment has been minimized.

Contributor

valentina-s commented Dec 12, 2016

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?

@tbekolay

This comment has been minimized.

Contributor

tbekolay commented Dec 31, 2016

is there some place to put supplementary materials

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 _extras folder will be added to that list, so we could add an "external resources" page or something like that. The notebooks would have to be placed somewhere easily (and ideally permanently) accessible; any thoughts on where these could go? We won't add them to this repo due to the difficulty in keeping them in sync with the lessons.

@plstonge

This comment has been minimized.

plstonge commented Jan 3, 2017

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.

Thanks!

rgaiacs pushed a commit to rgaiacs/swc-python-novice-inflammation that referenced this pull request May 6, 2017

Merge pull request swcarpentry#309 from k8hertweck/gh-pages
Adding accessibility changes from swcarpentry/styles

@maxim-belkin maxim-belkin force-pushed the swcarpentry:gh-pages branch from 4753644 to 90848ea Oct 12, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment