Re: [cp-discuss] Advices on instructing Git lesson online
I have instructions on how to work collaboratively and put people in breakout rooms. I teach my own course, not the Carpentries' lesson, and it generally goes well. There are always people who can't follow instructions in person as well as online so I don't find there are any more problems online vs in person. http://gcapes.github.io/git-course/09-remote-collaboration/#collaborating-on-a-remote-repository Version control with Git: Collaborating with a remote repository<http://gcapes.github.io/git-course/09-remote-collaboration/#collaborating-on-a-remote-repository> which compares our master branch with the origin/master branch which is the name of the master branch in origin which is the alias for our cloned repository, the one on GitHub.. We can then merge these changes into our current repository, but given the history hasn’t diverged, we don’t get a merge commit — instead we get a fast-forward merge. $ git merge origin/master gcapes.github.io Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: Clara Llebot Sent: 11 March 2021 17:23 To: discuss Subject: Re: [cp-discuss] Advices on instructing Git lesson online Hi Iñigo, I have taught the Git lesson several times in online mode (as a standalone workshop, not as a full carpentries two day workshop). I think that the key here is the number of students. I usually have 10 students or less, and with that number of students is pretty straightforward to do the collaborative part. I do not put them in breakout rooms, because I find it cumbersome to send them in and out, and I do not want to have to give them a bunch of instructions at once, I think that going slowly step by step is important. I divide them in pairs according to where they are in my screen, which hopefully is random enough, and make sure that I assign to each of them the role of owner or collaborator. I love that Zoom shows everybody's name clearly, it is so easy to refer to each student individually that way (at the beginning of the class I make sure I know how to pronounce their names). I devote the time I need to make sure that everybody knows who their partner is, and whether they are owner or collaborator. When I model each of the commands in the lesson I use two different terminal screens to show what the owner does, and what the collaborator does. To make it more clear I make one of the terminals have a different background color. Since there aren't that many students, they use the chat to communicate with each other when needed. And if they have questions they can unmute themselves. It is usually a very dynamic class, they ask lots of questions, and it works very well. I tried doing the same thing with a class that was large once and it was quite a disaster, but there were more than 30 people in the class. I would definitely recommend doing it demo style with classes with lots of people. If you have around 30 students an idea that comes to mind is getting a second instructor for the collaborative part of the lesson, and have two groups, each with 15 participants and one instructor. I have a recording of one of the classes I taught this way, but I told the students I would not make the video public, that I would only share it with people who requested it. So, send me a message if you are interested in the recording :) Good luck! Clara This list is for the purpose of general discussion about The Carpentries including community activities, upcoming events, and announcements. Some other lists you may also be interested in include discuss-hpc, discuss-r, and our local groups. Visit https://carpentries.topicbox.com/groups/ to learn more. All activity on this and other Carpentries spaces should abide by The Carpentries Code of Conduct found here: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html The Carpentries<https://carpentries.topicbox.com/latest> / discuss / see discussions<https://carpentries.topicbox.com/groups/discuss> + participants<https://carpentries.topicbox.com/groups/discuss/members> + delivery options<https://carpentries.topicbox.com/groups/discuss/subscription> Permalink<https://carpentries.topicbox.com/groups/discuss/T6b90a0b293fe9928-M3216c8cf5e5af8eab6cd351c> -- This list is for the purpose of general discussion about The Carpentries including community activities, upcoming events, and announcements. Some other lists you may also be interested in include discuss-hpc, discuss-r, and our local groups. Visit https://carpentries.topicbox.com/groups/ to learn more. All activity on this and other Carpentries spaces should abide by The Carpentries Code of Conduct found here: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/T6b90a0
Re: [cp-discuss] teaching R with tidyverse and ggplot
https://uomresearchit.github.io/r-tidyverse-intro/ This was put together by a former colleague, based on the software carpentry lesson. It has been very well received by learners. Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: Tom Wright Sent: 11 March 2021 13:25 To: discuss Subject: RE: [cp-discuss] teaching R with tidyverse and ggplot Thanks Rebecca, The lesson on manipulating data is exactly what I was looking for. -Original Message- From: Rebecca Lange Sent: Wednesday, March 10, 2021 11:22 PM To: discuss Subject: Re: [cp-discuss] teaching R with tidyverse and ggplot Hi Tom, The data carpentry ecology lesson uses tidyverse and ggplot: https://datacarpentry.org/R-ecology-lesson/ <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdatacarpentry.org%2FR-ecology-lesson%2F=04%7C01%7C%7C8431ba53a60148b347c008d8e445513f%7C84df9e7fe9f640afb435%7C1%7C0%7C637510333649527577%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000=84Rw3wNenMBtfSOwldmRwvu9smfJsX9QGUtcRAdcd6M%3D=0> It's my usual go to lesson when we run R training. All the best, Rebecca On 10 Mar 2021, at 11:40 PM, Tom Wright mailto:t...@maladmin.com> > wrote: Just wondering if there is work being done developing an R course using tidyverse with ggplot. Searching the forums it seems most posts are a few years old, am I missing anything interesting? Thanks, tom This list is for the purpose of general discussion about The Carpentries including community activities, upcoming events, and announcements. Some other lists you may also be interested in include discuss-hpc, discuss-r, and our local groups. Visit https://carpentries.topicbox.com/groups/ to learn more. All activity on this and other Carpentries spaces should abide by The Carpentries Code of Conduct found here: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html The Carpentries <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fcarpentries.topicbox.com%2Flatest=04%7C01%7C%7C8431ba53a60148b347c008d8e445513f%7C84df9e7fe9f640afb435%7C1%7C0%7C637510333649537568%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000=TyaYpLFy35VuJe5xu%2F1tgIv0lQQ7ooTJzp%2FBlsz1CU0%3D=0> / discuss / see discussions <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fcarpentries.topicbox.com%2Fgroups%2Fdiscuss=04%7C01%7C%7C8431ba53a60148b347c008d8e445513f%7C84df9e7fe9f640afb435%7C1%7C0%7C637510333649537568%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000=vsOKMhIZv2nOudQOI3QeDQb7WDBaswXaYlNJaZ53NPM%3D=0> + participants <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fcarpentries.topicbox.com%2Fgroups%2Fdiscuss%2Fmembers=04%7C01%7C%7C8431ba53a60148b347c008d8e445513f%7C84df9e7fe9f640afb435%7C1%7C0%7C637510333649547566%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000=XxkjfNyZFQ6LODk0xxc1FJitj%2BUAv9i%2F0oajcUUgjE4%3D=0> + delivery options <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fcarpentries.topicbox.com%2Fgroups%2Fdiscuss%2Fsubscription=04%7C01%7C%7C8431ba53a60148b347c008d8e445513f%7C84df9e7fe9f640afb435%7C1%7C0%7C637510333649547566%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000=dv3DZLUjsUKrtWk%2B%2FCzeSq85L3jpYa2avneB8fIlWYA%3D=0> Permalink <https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fcarpentries.topicbox.com%2Fgroups%2Fdiscuss%2FT380438d783cde0f3-Mef3ce63a85b1639ab29d7cf1=04%7C01%7C%7C8431ba53a60148b347c008d8e445513f%7C84df9e7fe9f640afb435%7C1%7C0%7C637510333649557560%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000=i8YLZsx63VCBHr3tIQmYbc29XRl2QrNBD7lMGtWRuVw%3D=0> -- This list is for the purpose of general discussion about The Carpentries including community activities, upcoming events, and announcements. Some other lists you may also be interested in include discuss-hpc, discuss-r, and our local groups. Visit https://carpentries.topicbox.com/groups/ to learn more. All activity on this and other Carpentries spaces should abide by The Carpentries Code of Conduct found here: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/T380438d783cde0f3-Mc07b0c9fba510b1320eddab8 Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
[discuss] RE: Lessons for lesson writer
It's not a complete guide, but the reverse instructional design section here should be helpful: https://carpentries.github.io/instructor-training/15-lesson-study/index.html Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: Purwanto, Wirawan [wpurw...@odu.edu] Sent: 09 October 2019 21:29 To: discuss@lists.carpentries.org Subject: [discuss] Lessons for lesson writer Hi all, The subject is not a pun. :-) I wonder if there is already a lesson written by someone in this community (or beyond)--doesn't have to be in the Carpentry style--on how to write lessons a la Carpenties, i.e. to introduce a new computing topic to complete novice. I think there is an art to this approach, because we don't want to bog down new learners with everything there is to know (even at the novice level), but hit enough points so that learners take away useful things from the workshop. Wirawan Get Outlook for Android<https://aka.ms/ghei36> The Carpentries<https://carpentries.topicbox.com/latest> / discuss / see discussions<https://carpentries.topicbox.com/groups/discuss> + participants<https://carpentries.topicbox.com/groups/discuss/members> + delivery options<https://carpentries.topicbox.com/groups/discuss/subscription> Permalink<https://carpentries.topicbox.com/groups/discuss/Tcf21e99525a6f49c-M5ed230742ecfff8e62f754e0> -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/Tcf21e99525a6f49c-Mfb6028fe3af2819668ea732a Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
[discuss] How to import file into etherpad (for instructor training)
Dear knowledgeable Carpentries people, I'm preparing to teach an instructor training workshop, and I'm creating a shared document for the learners. I know about the etherpad template https://pad.carpentries.org/ttt-template, and that I can export this in various formats. I don't yet know if the current etherpad is up-to-date, or if/how changes to the curriculum make their way into this etherpad template. I would like to code something up which would automatically strip the exercises from the current curriculum, and create a (markdown/ html) document containing only those exercises. Assuming I do that, I would like a way to import that back into an etherpad. Does anyone know how to import a file into an etherpad? I attempted it with an html file, but no changes were made to the etherpad, and there was no error message. Thanks Gerard -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/T35e19d5364d2d968-Ma41244b26fbbd27ab0b7b7bd Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
RE: [discuss] Whitespace character in Windows system
Does Anaconda have to install to the user home directory? There might be the option to install to another directory e.g. C:\anaconda Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: Purwanto, Wirawan [wpurw...@odu.edu] Sent: 21 August 2019 04:03 To: Mauricio Vargas; discuss Cc: Purwanto, Wirawan Subject: Re: [discuss] Whitespace character in Windows system Hi Mauricio— Thanks for that valuable information! The procedure described in the referred answer is quite surgical in nature. Which means that it has a lot of potential pitfalls for novice users. I wonder if (1) other instructors have noted problem with spaces in user names in Windows, and (2) if there is a simpler mitigation plan for this issue. I was thinking a naïve workaround, which is to create a separate user name with no whitespace characters. The drawback is that then the user will have problem with using the setup for the real work, where files reside on the other user profile. Wirawan From: Mauricio Vargas Date: Tuesday, August 20, 2019 at 12:09 PM To: discuss Cc: "Purwanto, Wirawan" Subject: Re: [discuss] Whitespace character in Windows system I had that problem as well !!! the second reply here helped me changing it: https://stackoverflow.com/questions/35175814/windows-10-username-with-whitespace-and-path<https://nam03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fstackoverflow.com%2Fquestions%2F35175814%2Fwindows-10-username-with-whitespace-and-path=02%7C01%7Cwpurwant%40odu.edu%7Cca90c9a4df404a686b8008d72588ce1d%7C48bf86e811a24b8a8cb368d8be2227f3%7C0%7C0%7C637019141845271199=%2FJFBziS6IwMFMGjtwgcTTdb59OL0OM4LbSfjYpCJZbI%3D=0> glad I bookmarked it — Mauricio Vargas Sepúlveda 帕夏 Do you like Data Science? visit pacha.hk<https://nam03.safelinks.protection.outlook.com/?url=http%3A%2F%2Fpacha.hk%2F=02%7C01%7Cwpurwant%40odu.edu%7Cca90c9a4df404a686b8008d72588ce1d%7C48bf86e811a24b8a8cb368d8be2227f3%7C0%7C0%7C637019141845271199=%2FgRZQ66dt13%2BTGQDa1rhiGsf7wfSVs4NEr6kWzGF33o%3D=0> 你爱科学数据专吗?你走pacha.hk<https://nam03.safelinks.protection.outlook.com/?url=http%3A%2F%2Fpacha.hk%2F=02%7C01%7Cwpurwant%40odu.edu%7Cca90c9a4df404a686b8008d72588ce1d%7C48bf86e811a24b8a8cb368d8be2227f3%7C0%7C0%7C637019141845281189=EtDGBxsNBE%2BL0rATKq0X6ytRsaSqQQk55lhytQGqmgY%3D=0> On Tue, Aug 20, 2019 at 11:33 AM Purwanto, Wirawan mailto:wpurw...@odu.edu>> wrote: Hi all, I am about to hold a software carpentry event, and in the course of helping users install their software, I found warning with Anaconda install. The culprit was white space in the user name .. something too common on Windows systems. Anyone have comment or workaround on this issue? Will the whitespace cause problems with UNIX shell and Python hands-ons? Wirawan Get Outlook for Android<https://nam03.safelinks.protection.outlook.com/?url=https%3A%2F%2Faka.ms%2Fghei36=02%7C01%7Cwpurwant%40odu.edu%7Cca90c9a4df404a686b8008d72588ce1d%7C48bf86e811a24b8a8cb368d8be2227f3%7C0%7C0%7C637019141845281189=DgE%2Ft9ubkdlp0F4ruxwib6SNvE0Zn7T0lUn1gOn%2BXRw%3D=0> The Carpentries<https://carpentries.topicbox.com/latest> / discuss / see discussions<https://carpentries.topicbox.com/groups/discuss> + participants<https://carpentries.topicbox.com/groups/discuss/members> + delivery options<https://carpentries.topicbox.com/groups/discuss/subscription> Permalink<https://carpentries.topicbox.com/groups/discuss/Td5778fd937d9d0df-Mc55a41a720fcfe19330eab80> -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/Td5778fd937d9d0df-Mb444d48e523d048402e10fd5 Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
RE: [discuss] Carpentry-style lesson that covers git branching?
Feel free to use gcapes.github.io/git-course if you think it's useful. Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: E. Madison Bray [erik.m.b...@gmail.com] Sent: 25 July 2019 10:12 To: discuss Subject: Re: [discuss] Carpentry-style lesson that covers git branching? It seems there have already been several links to resources, but I'd like to add one more that's been around for a long time now, but I think is still underutilized--I found it great even when I was relatively new to git, and trying to understand git branching and rebasing better: https://learngitbranching.js.org/ It won't necessarily be of immediate help planning a SWC-style *lesson* on the subject, but I have often given this tutorial to students who were eager to learn more, to go through it self-directed. It's quite good for that I think. Best, Madison On Wed, Jul 24, 2019 at 11:54 PM Sumana Harihareswara mailto:s...@changeset.nyc>> wrote: > > I'm training a new contractor on basic shell and git, and the Software > Carpentry materials have been FANTASTIC. > > But I would like to teach her about branching and pull requests next. I > recognize and understand that the git novice lesson doesn't cover branching > and I totally get why > https://swcarpentry.github.io/git-novice/guide/index.html . I would like to > continue with a Carpentry-style approach that uses live coding, frequent > formative assessment (including exercises with solutions), making mistakes > and working through them, incremental diagram presentation, and so on, as in > http://third-bit.com/2019/06/15/10-quick-tips-for-delivering-a-programming-lesson.html > . Is anyone aware of such a lesson, covering branches and GitHub pull > requests? Or is anyone working on one? I'm aware of some resources but > haven't found anything that is quite what I am looking for: > > * https://learngitbranching.js.org/ > * > https://github.com/lexnederbragt/github_collab_workshop/blob/master/workshop_outline.md > * https://github.com/dlab-berkeley/git-fundamentals and in particular > https://github.com/dlab-berkeley/git-fundamentals/blob/master/pdfs/0-7_branching.pdf > > I don't want to reinvent the wheel, and I'd like to use/test/contribute to > such a lesson if it exists. > > Thanks, > Sumana Harihareswara > The Carpentries / discuss / see discussions + participants + delivery options > Permalink The Carpentries<https://carpentries.topicbox.com/latest> / discuss / see discussions<https://carpentries.topicbox.com/groups/discuss> + participants<https://carpentries.topicbox.com/groups/discuss/members> + delivery options<https://carpentries.topicbox.com/groups/discuss/subscription> Permalink<https://carpentries.topicbox.com/groups/discuss/T88a5a6f29942ba00-M0b452db1d00050dc01008f3a> -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/T88a5a6f29942ba00-M82e2aa477437d05052f8862e Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
[discuss] Feedback on pull request skill-up workshop
Hi everyone, I'm planning to teach a skill-up workshop on contributing to carpentries' lesson at Carpentry Connect 2019. I've got most of a lesson together and would like feedback from interested parties - please create an issue. https://github.com/gcapes/swc-pr-tutorial I also know that there are already a couple of GitHub contribution guides floating around - hopefully we can put all the ideas in once place :) Thanks Gerard -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/T615bc039aed54b12-Mf0a819d8a5bc400091ab2581 Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
[discuss] RE: New Windows Terminal announced
Thanks for sharing this Cam. If anyone has any experience with it they'd like to share, feel free to create an issue on the shell lesson: https://github.com/swcarpentry/shell-novice Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: Cameron Macdonell [cameron.macdon...@macewan.ca] Sent: 06 May 2019 20:53 To: discuss Subject: [discuss] New Windows Terminal announced Hi, Some may have already seen this, but I find this a pretty exciting development – a new Terminal for Windows. https://devblogs.microsoft.com/commandline/introducing-windows-terminal/ It will take some time to determine if it suites our needs better than Git Bash, but I’m always hopeful for something that will improve the terminal experience on Windows. Cam -- Dr. Cam Macdonell, PhD Asst Professor and Chair Dept of Computer Science MacEwan University cameron.macdon...@macewan.ca<mailto:cameron.macdon...@macewan.ca> 780.497.5625 The Carpentries<https://carpentries.topicbox.com/latest> / discuss / see discussions<https://carpentries.topicbox.com/groups/discuss> + participants<https://carpentries.topicbox.com/groups/discuss/members> + delivery options<https://carpentries.topicbox.com/groups/discuss/subscription> Permalink<https://carpentries.topicbox.com/groups/discuss/Td74fc3443d4373bc-M46bc1aa5362a78aed8311d0d> -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/Td74fc3443d4373bc-M76186ada541e54c7b63e2e80 Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
RE: [discuss] Git website instructions
Good to hear that. If miniconda has the required python packages for the python and make lessons, perhaps someone could suggest set up steps at https://github.com/carpentries/workshop-template/pull/536 or https://github.com/carpentries/workshop-template/issues/512 Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: João Rodrigues [j.p.g.l.m.rodrig...@gmail.com] Sent: 08 January 2019 13:12 To: discuss Subject: Re: [discuss] Git website instructions I second what Pey Lian Lim said. Installing miniconda on git bash will add the appropriate definitions to .bashrc so that python is directly available without further hassle. I would probably stick with option 1 on that installation though, to have a self-contained installation. Otherwise people might load cmd.exe for instance, run git, see that it works, and then try to use other UNIX tools or Python and be left confused as to why they don't work as they did in the tutorials (sort comes to mind..). The Carpentries<https://carpentries.topicbox.com/latest> / discuss / see discussions<https://carpentries.topicbox.com/groups/discuss> + participants<https://carpentries.topicbox.com/groups/discuss/members> + delivery options<https://carpentries.topicbox.com/groups/discuss/subscription> Permalink<https://carpentries.topicbox.com/groups/discuss/Tdbe7b1d8f26530a2-M4985d1d5344413ea98309aa8> -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/Tdbe7b1d8f26530a2-Me07041b5291a152abd2819b4 Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
[discuss] RE: Broadcasting your shell session
Looks great - thanks for sharing! Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: ANTONIOLETTI Mario [m.antoniole...@epcc.ed.ac.uk] Sent: 04 October 2018 10:43 To: Software Carpentry Discussion Subject: [discuss] Broadcasting your shell session Hi, We are doing a run of the shell lesson next week. On inspection the configuration of the room we are supposed to use was suboptimal with some deskis to their backs to the screen with only one screen in the room. We found this piece of software: https://shellshare.net/ That works really well on a one-to-one basis. It broadcasts your shell output to a URL that people can view on a browser. We will have around 25 students on Tuesday so we shall see if it scales. I will report back post couse but some of you may want to play with this. If anyone has used this before let me know if there are any things to be aware of. Cheers, Mario +-+ |Mario Antonioletti:EPCC,Bayes Centre,47 Potterrow, Edinburgh EH8 9BT | | Tel:0131 651 3534|m.antoniole...@epcc.ed.ac.uk | +-+ -- The University of Edinburgh is a charitable body, registered in Scotland, with registration number SC005336. -- The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/Tc050def6f4b5b17c-M5de7013dfafa689b4253163a Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
RE: [discuss] Slide of Joel Grus' JupyterCon Talk "I Don't Like Notebooks"
+1 Notebooks are convenient, but the set up, kernel crashes, and 'when would I use a notebook vs spyder' questions make it seem a strange choice to me. One thing it does have though is an easily visible history of commands and their output. Thanks Gerard -- Gerard Capes Research Applications, IT Services, University Of Manchester From: Kevin Vilbig via discuss [discuss@lists.carpentries.org] Sent: 28 August 2018 05:15 To: discuss Subject: Re: [discuss] Slide of Joel Grus' JupyterCon Talk "I Don't Like Notebooks" All, I do not like Jupyter notebooks for teaching, either and I have been thinking this privately for a while. They carry a lot of cognitive load compared to a straightforward CLI REPL, which we actually tout as the best way to start learning in our materials. I have taught a few SWC workshops and mostly stuck to the CLI and git lessons for that reason. I have taught some DC as well, but those are a different beast and are actually flow a lot more tightly compared to the SWC workshops. I suspect Jupyter notebooks as being the culprit. The notebooks seem good for people who learned to code from MATLAB or Mathematica because they superficially resemble those systems, but that is not most people that we teach nor even necessarily most of our teachers. I think it would be best practices (especially for the general pedagogical theories that we use) to teach Python at the level of a text file written in the same text editor we use for the other lessons. Then we should be running those scripts as files from the same command lines we use in the other lessons. Iirc this was the case until the lessons were changed to incorporate the Jupyter notebooks. This method would reduce cognitive load and increase mutual scaffolding between the lessons rather than needing a major cognitive gear-shift between CLI work and a browser-based IDE. I always wondered why there seems to be a disconnect between the other lessons where we really do keep it simple. Is it just to have some flashy GUI to show off like we have RStudio for the R lessons? I would prefer to teach the basics (variables, arrays, etc.) using the Python interpreter running from the command line, how to save and run a script using a text editor from the command line, and using the techniques we taught in other lessons like command line arguments. If the teacher uses Jupyter in their actual work, they can show off their work if there is extra time, (Maybe we should build a 25-30 minute segment like that into the lesson plan?) but we shouldn't be starting there. -K On Mon, Aug 27, 2018 at 1:31 PM Purwanto, Wirawan mailto:wpurw...@odu.edu>> wrote: Jory, Great moderating points. I don’t think we should throw Jupyter out of the window completely, but we need to know how to use this tool. Drawing from my days using ipython: Jupyter is basically a web-based ipython with lots of candies added. There is one feature of ipython that allows you to log the “In[NNN]” and the “Out[NNN]” of the python code: %logstart -t -o LOGFILENAME I just checked that this also works on a jupyter session. LOGFILENAME is just a text log file. After invoking this statement (once, at the beginning of your python Jupyter session), every input and output will be logged. But the output of “print” statements or inline graphics (such as pyplot output) are not saved. (There are tricks to make that happen, but that’s a topic for another thread.) But this approach allows you to reason the mystery kernel codes, because ipython logging won’t lie, and won’t be subject to cell editing (the input/output you deleted on Jupyter will still be there in the log file). I added “-t” flag to “logstart” magic in order to add timestamp to the logged inputs, because sometimes I work on a notebook for a long time, and lose track of when I did what. I would combine real software engineering (i.e. using modules, good coding practices) for the heavy-lifting codes, and use Jupyter to produce a record of my interactive session. I don’t put very long codes in Jupyter cells, because that becomes clutter to me. But again, this would call users to be a little bit more savvy: to be able to interact with both the modules/other python source files and the Jupyter notebook at the same time. -- Wirawan Purwanto Computational Scientist, Research Computing Group Information Technology Services Old Dominion University Norfolk, VA 23529 From: Jory Schossau via discuss mailto:discuss@lists.carpentries.org>> Reply-To: discuss mailto:discuss@lists.carpentries.org>> Date: Saturday, August 25, 2018 at 10:04 AM To: "discuss@lists.carpentries.org<mailto:discuss@lists.carpentries.org>" mailto:discuss@lists.carpentries.org>> Subject: Re: [discuss] Slide of Joel Grus' JupyterCon Talk "I Don't Like Notebooks" I agree with most of the points everyone's making here, and just wan