The Plan
1
Most scientists need version control,
But few can use it
Kathryn Harris (@gerudo7) wrote the following story to help a new collaborator learn to use version control. We wanted to communicate the power of version control and thought a story might help.
Could user-centered stories help more scientists use git?
2
work by @gerudo7
3
work by @gerudo7
4
work by @gerudo7
5
… the saga continues!
Ralph teaches Chubby Cheeks and Pikachu to work together on an existing repository. Printed, the story folds into a small booklet. I got this idea from the CUP Title IX poster.
Materials hosted at: https://gitlab.com/git-stories
Get help with git and join the discussion: https://git-stories.slack.com
Get in touch with me: Amy Roberts, 2021 BSSw Fellow, amy.roberts@ucdenver.edu
6
Roadmap
“How to share your work,” an overview of the most-commonly-used git commands (commit, pull, and push - git clone and git init will be mentioned here but only briefly as there is existing Software Carpentry material to point to)
“Every commit requires a comment,” a walk-through of what happens during a commit and how to use the “-m” flag to avoid editor pitfalls.
“When is it time to commit?” will provide specific examples of users who need to commit their code. We are particularly excited about the art possibilities for this item. Users often avoid committing code because they are afraid of breaking something or because they feel their code isn’t good enough. We will use art to express these emotional aspects and then point to technical features of version control (branches, code review on hosting sites) that are meant to provide space for imperfect code.
More roadmap ideas at Version Control Art and User Stories - Google Doc
7
Breakout Discussion
Suggested topic: what version control support do I need?
Take notes at: ECP 2022 Make it better - version control
8
Thank You!
9