Library Carpentry sprint, 10-11 May, 2018
For those new to the field, a sprint is like a hackathon - it is a way to get people working together to create, update or extend open projects like Library Carpentry.
Join us to be part of it!
For the lessons, we welcome contributions from librarians, archivists, information workers, digital humanities researchers … anyone who wants to contribute to building either the lessons and this burgeoning community (or both!).
For the website, we welcome suggestions, edits, pull requests, corrections - you name it.
Not sure what Library Carpentry is? Check out our ‘front page’. This provides links to our published lessons.
For the ‘back end’, repository view of the lessons, check out the lessons prefixed
Registering a site
Use this form to tell Mozilla you are hosting a site. https://docs.google.com/forms/d/e/1FAIpQLSdyLD5iv0HvURB-r9ejUz3NAO4wD0B1g-FBvIBgyZCaZj627g/viewform
Add your site as well to our sprint etherpad: http://pad.software-carpentry.org/lc-sprint-2018
How will the sprint work?
These are the issues we want to work on during the sprint. To find out how you can help, look at the README and CONTRIBUTING files. The issues we hope to resolve are all labelled #mozsprint. Feel free to create new issues if you need to.
People can start working straightaway on any of the #mozsprint issues. There will be designated people available to answer questions at most times during the sprint. We will use the chatroom to wrangle those questions and clarifications. You will be able to ask questions via scheduled video calls as well (which we will also use for networking). If you are not sure about something, please post a question in the chatroom (directed to someone in particular, if need be) and someone will get back to you.
How the sprint will be organised
There are a number of dedicated sprint site locations (see them here), all of which will start working at different times as the sun moves around the globe. People may also be working remotely. Sites will organise their own work and report back on how things are going during video calls, via the chatroom, or through the daily handovers (where the baton will be passed on to the next locations). regisyter your site here: https://docs.google.com/forms/d/e/1FAIpQLSdyLD5iv0HvURB-r9ejUz3NAO4wD0B1g-FBvIBgyZCaZj627g/viewform and add it to the etherpad as well
Handovers will take place at the end of the work day in the southern hemisphere and at the beginning of the new work day there.
Sprinters can work on whatever lessons or issues they like. If you are not a coder, try to pair up with others and work through a lesson of your choice. Then raise issues, ask questions, suggest changes, or propose scenarios or workflows you would like to see addressed. We are interested as much in ideas and feedback as in new code. Our aim is to make the lessons as useful and as relevant as possible to librarians, archivists and other information workers. If you have a dataset to contribute that would help make a good lesson, that would also be useful.
You can use the sprint to network. Most of the Library Carpentry community will be taking part in this sprint at different times. Use the sprint to meet these people virtually and talk about running a workshop, hosting a workshop, or other issues that have cropped up for you, your institution or your country. We want to spread the Library Carpentry word as far and wide as possible, so use the sprint to find out how you can help.
Our etherpad is another tool we will use for organising the work of the sprint. Dedicated etherpads will be created for each lesson being worked on - they will be listed on this etherpad once the sprint is underway. The individual repositories are all listed below.
Links to video calls will also be posted on the etherpad, with the scheduled times - all links will show the time and date in your zone.
Since people are working both at dedicated sites (see the etherpad for locations) and remotely, we will touch base regularly so everyone feels part of things. You can use the chatroom at any time to say in touch, or to post updates or ask questions.
If you are a tweeter, please tweet about the event using the handle @LibCarpentry and the hashtags #lc2018 and #mozsprint. Photos are good too. It would be great to have photos of each site’s people working away so we can do an illustrated blog post of how the sprint went.
What you can do
Work on existing lessons by
- submitting pull requests to suggest changes (please keep each pull request small - one or two changes only per PR - to make them easier to manage for maintainers)
- raising issues for discussion/amendment against specific lessons using the Issues tab on each lesson
- chatting with others in the chatroom or via the daily catchups and video calls
- working through lessons with colleagues as a way of familiarising yourself with the material
- discussing the project with colleagues, especially about how you might bring Library Carpentry to your institution
- identifying any confusing gaps or assumptions in lessons so we can make the lessons more learner-friendly.
Social Media and Communications
The sprint hashtag are #lc2018 and #mozsprint. Please use these to tie tweets together, and also include Library Carpentry’s Twitter handle, @LibCarpentry, if you can.
If you post images on Instagram or Facebook, please send us a link via the chatroom so we can tweet them.
This is a list of people who maintain each Library Carpentry lesson. If you are editing a lesson, be sure to check in with them throughout the sprint. Volunteers to help maintain a lesson after the sprint are always welcome!
Individual Lesson links and GitHub IDs of Lesson Maintainers*
Git - weaverbel, jezcope
Shell - weaverbel, jt14den
OpenRefine - ostephens, ccronje, pitviper6
New Draft Python - c-martinez, richyvk
Tidy Data from Spreadsheets - jezcope
SQL - c-martinez, icejan
Data Intro, Jargon Busting, Regex - drjwbaker, ccronje
Data Intro for Archives - drjwbaker