Summary of June 2014 Lab Meeting
This post originally appeared on the Software Carpentry website.
At our monthly lab meeting yesterday (June 26), we discussed a wide range of topics (though only about half as much as was on the agenda). Details notes and votes are below; the key points are:
- We would like to do what we can to help the careers of people who volunteer for Software Carpentry. In particular, we'd like to find a way to highlight people who have taught lots of bootcamps, contributed lots of material, or both, without discouraging people who haven't, or getting into a situation in which bootcamp hosts ask, "Why aren't you sending your most experienced people to us?" We've opened a GitHub issue for people who'd like to discuss this topic, and we'd be grateful if you could share experiences with other systems and suggestions about what we could do.
- We will have a meeting on Thursday, July 3 to discuss plans for the July 22-23 sprint. The time and connection details will be posted here on July 2.
- People were either neutral or in favor of switching to Python 3.
There was concern about compatibility,
but it seems that most scientific packages are now Py3-compatible
(and that there are some that only work with Py3, and not with Py2).
In practice, this will mean:
- changing what people have on their machine when they leave the bootcamp, and
- minor modifications to our lessons (e.g.,
print
as a function).
- By default, Mercurial launches a GUI diff/merge tool when there's a conflict rather than displaying a textual diff. Novices seem to find side-by-side merge easier to work with, which raises the question: should we use a graphical tool for diff and merge when teaching Git as well? Again, most people were either neutral or in favor, subject to ease of installation. We'll try this at a couple of workshops in the coming months and report back.
- Should we install Matt Davis's
ipythonblocks
module by default? Nobody was opposed, but it turned out that only a handful of people actually use it in teaching. We'll poll our instructors to find out more about usage before making a final decision. - In order to make it easy for people who want to teach regular expressions to do so,
we'll integrate the software that runs regexpal.com
(which ironically is down at the time of this writing)
into the
bc
repo so that instructors can create a page in their bootcamp site where learners can play around. - Jonah Duckles has created a pull request
that would change the way installation instructions are managed.
Instead of editing
_includes/setup.html
, instructors would add a list of topics to the header ofindex.html
that Jekyll's templating logic would use to control what is and isn't displayed. Most people were in favor, so we'll merge this once the PR is finished. - Many people are still not happy with the way our lesson materials are organized, or with what pre-requisite knowledge we actually expect. We will organize a meeting for next Thursday (July 3) to talk about options, then open a discussion issue on GitHub if we can come up with concrete alternatives.
- Raniere Silva has been working over the last few weeks to generate EPUB and PDF from our materials. The goal is to allow anyone who wants to produce book-form notes to do so for use in a regular class, to give to learners after a bootcamp, or for self-study. He's been making good progress, but there are still lots of small problems (particularly with the PDF). We'll be hacking on this at the sprint.
Agenda
- Announcements
- Directions
- Volunteers/Reviewers Wanted
- Plans for the July 22-23 sprint: https://etherpad.mozilla.org/swc-sprint-2014
- Other Business
- Online Helpouts (Russell Alleen-Willems)
Attendees (Second Round)
- Greg Wilson (Mozilla, Toronto)
- Gabriel Devenyi (McMaster, Hamilton, @staticwave_ace)
- Matt Davis (Synthicity, Berkeley (@jiffyclub))
- Jeramia Ory (King's College, PA @DrLabRatOry)
- Jens von der Linden (University of Washington, Seattle)
- Kwasi Kwakwa (Imperial College London)
- Xu Fei (New York, NY)
- Jeremiah Lant (Louisville, Kentucky)
- Christian Jacobs (Imperial College London, UK)
- Erika Mudrak (Cornell, Ithaca @ErikaMudrak)
- Bernhard Konrad (Vancouver, BC)
- Tim McNamara (Auckland, NZ)
- Aron Ahmadia (Washington, D.C.)
- Chris Beitel (UC Davis; Eisen Lab; @datascimed)
- Ben Marwick (U of Washington, Seattle, @benmarwick)
- Katy Huff (UCBerkeley)
- Damien Irving (University of Melbourne, Australia / @DrClimate)
- Amanda Harlin (Uni of Oklahoma, @amandaharlin)
Attendees (First Round)
- Raniere Silva (University of Campinas, São Paulo, Brazil
- Rémi Emonet (University of Saint Étienne, France)
- Jonah Duckles (University of Oklahoma, Norman, Oklahoma @jduckles)
- Brian Northan
- Pauline Barmby, (Western U, London Canada, @PBarmby)
- Russell Alleen-Willems (Diachronic Design, Seattle, Washington, @DiachronicD)
- Marios Isaakidis (@misaakidis)
- Denis Haine (U of Montreal)
- Ethan White (Utah State University / @ethanwhite)
- Emily Davenport (University of Chicago)
- Lex Nederbragt (University of Oslo)
- Stephen Turner (University of Virginia, @genetics_blog)
- Karin Lagesen (University of Oslo, @karinlag)
- François Michonneau (University of Florida, @FrancoisInvert)
- John Blischak (University of Chicago)
- Brian Glanz (@openscience, Wash DC today)
- Dana Bauer (Rackspace, Philadelphia)
- Azalee Bostroem (Space Telescope Science Institute)
- Sheila Miguez (Chicago, IL)
- Abigail Cabunoc (OICR, @abbycabs)
- Tracy Teal (@tracykteal)
- Rob Davey (@froggleston - joined late!)
- Amy Brown (@amyrbrown)
Announcements
- See {{site.github_url}}/bc/issues?labels=getting-started for issues that instructor trainees are encouraged to work on
- How should we mentor new instructors?
Directions
- Lessons in Python and R on creating packages?
- {{site.github_url}}/bc/issues/536 (this is OS X commands lack features...)
- {{site.github_url}}/bc/pull/507
- Volunteers:
- I'm happy to give a look at the R packaging lesson (François Michonneau)
- The R lesson could still use some reviews. Josh is going to respond to the current round of reviews in the next week or so (John Blischak)
- I could help with this in Python. - jiffyclub
- I would be happy to help with this in Python - Jeremiah Lant
- Good Python packaging hints here: http://python-packaging-user-guide.readthedocs.org/en/latest/
- Switch to Python 3?
- Is it fully science-supporting? (numpy, scipy....)
- Those ones, yes.
- Anaconda now supports it
- "Canopy provides access to Python 2.7.6" - no indication on side of 3.0 support
- But most code is still written in Python 2.7
- Integer division is a huge stumbling/exasperation point for novices
- Votes: 0 +1+10 +1+0-100+1+10000+0.50+1+1+1+1+10000+100
- Votes for using 3.* syntax but installing 2.7: -1+1+1-1-1+1+1
- List of incompatible packages? Currently summarized in {{site.github_url}}/bc/issues/107#issuecomment-32144981
- Is it fully science-supporting? (numpy, scipy....)
- Add a GUI diff/merge tool to our version control lessons?
- {{site.github_url}}/bc/issues/527
- https://stackoverflow.com/questions/426026/git-on-windows-how-do-you-set-up-a-mergetool
- Votes:+1+1 0+1+0.5+1+1+10-1+0.50-1+1+1+1+1-1+1+1+1+0+100-1+1
- Karin: +1 for gui, -1 if not cross platform, same here (ethan white, raniere silva, Jory Schossau)
- http://meldmerge.org/ does have cross-platform installers (an unofficial one for Windows, MacPorts/Fink for OSX, normal package management for *nix)
- P4Merge claims to be Mac/Linux/Windows: http://www.perforce.com/product/components/perforce-visual-merge-and-diff-tools
- Volunteers to give it a try:
- Install ipythonblocks by default?
- {{site.github_url}}/bc/issues/486
- note: it is used in some lessons
- Votes: +1+1+1+0+1+1-1+1+1+1+1+1+1+1
- How many people use it: Greg, Karin, Damien, Tracy (sometimes)
- Volunteers to do the work:
- Matt Davis
- Integrate regexpal.com into our lessons for teaching regular expressions
- See {{site.github_url}}/bc/issues/498
- Votes: +1 +1 +1+1+1+1+1+1+1+000+1+1+1+10+1
- Volunteers:
- Rémi: I could help if needed (and if it is just integration) - I could do something, it is not perfect from a style point of view but it seem to work (see the issue)
- Matt Davis
- How to decide on reorg of lesson material?
- Meeting: +1 +1
- GitHub issue: +1 +1 +1 +1 +1+1+1+1
- Mailing list thread:
- Use templates to control what's displayed in setup instructions
- {{site.github_url}}/bc/pull/415
- Votes: +1+1+10+1+10+000+00+1+1+1+10+1+1+1+1+10+10+1
- Highlight "senior" instructors somehow on the team page?
- See also {{site.github_url}}/bc/pull/570
- Suggestions: open a discussion thread - this one's complicated
- Count option can lead to "Senior" later by defining what that means
- EPUB version of lesson
- The majors issues was addressed: {{site.github_url}}/bc/pull/435 Raniere wants green light to merge all the related PR.
July 22-23 Sprint
- Planning: https://etherpad.mozilla.org/swc-sprint-2014
- Meet with hosts/project leaders/anyone else who's interested next Thursday (July 3) to talk details - if you're interested in being part of the meeting, please sign up below
- Raniere Silva
- Azalee Bostroem
- François Michonneau
- Brian Northan
- Brian Glanz
- Chris Beitel
- Matt Davis
- Amanda Harlin
- Damien Irving
- Tim McNamara
- Xu Fei
- Gabriel Devenyi
- April Wright
Other Business
- Google Hangouts/Helpouts
Volunteers/Reviewers Wanted (we didn't get to this because time ran out)
- Bioinformatics capstone example
- Really good discussion at {{site.github_url}}/bc/issues/532
- Volunteers: Karin L
- "Starry night" image manipulation using sk.image.novice and ipythonblocks
- {{site.github_url}}/bc/pull/508
- Reviewers:P Barmby
- Syndicating data as a way to introduce web programming
- {{site.github_url}}/bc/pull/513
- Replaces {{site.github_url}}/bc/pull/502
- Volunteers:
- {{site.github_url}}/bc/pull/513
- Creating slides to introduce topics
- {{site.github_url}}/bc/pull/510
- Needs work on CSS
- Needs intro decks for each major topic
- Hope to record these as "why you care about this lesson" videos
- See {{site.github_url}}/bc/issues/559
- Volunteers: Dav Clark, Jacob Levernier
- Novice lesson on indexing in NumPy
- {{site.github_url}}/bc/pull/487
- Reviewers: Jeremiah Lant
- Improving our "how do I do X?" instructions
- {{site.github_url}}/bc/issues/482
- Volunteers:
- Code review lesson + Git branching
- {{site.github_url}}/bc/issues/517
- {{site.github_url}}/bc/pull/471
- Volunteers:P Barmby R Davey
- What are we doing to do about statistics/data analysis/Pandas in Python?
- Add next/previous navigation links for lessons
- {{site.github_url}}/bc/pull/384
- Volunteers:
- Medical image processing example
- Rewriting shell lesson that it only talks about Nelle
- Minimal rewrite: {{site.github_url}}/bc/pull/535
- More extensive rewrite: {{site.github_url}}/bc/pull/437
- Notes: {{site.github_url}}/bc/issues/405
- Version control with Mercurial:
- Give instructors more credit
- Make their names more prominent on bootcamp webpages
- See {{site.github_url}}/bc/pull/570
- Votes: