Working Open – The Value of Open Source to Science

View Github Repository Open presentation in a new window

acabunoc

See all presentation from acabunoc

Working Open – The Value of Open Source to Science

1 0

work-open-webfest

Working Open: Hands-on workshop where you'll apply open practices to your project

On Github acabunoc / work-open-webfest

Working Open

The Value of Open Source to Science

slides: http://acabunoc.github.io/work-open-webfest

Abigail Cabunoc Mayes / @abbycabs

Hi! I'm Abby

I work at the Mozilla Foundation where I'm lead developer for the Mozilla Science Lab.

I want to use the web to move science forward.

We’re building a better Internet. Our mission is to promote openness, innovation & opportunity on the Web.

Helping researchers leverage the open web.

history of

The Academic Journal

The Open Source Movement

same problems, centuries apart

The Academic Journal

Enabling research since the 17th century!

First scientific journal: 'Philosophical Transactions of the Royal Society’, Royal Society of London, 1665

“We must be very careful as well of regist'ring the person and time of any new matter, as the matter itselfe, whereby the honor of the invention will be reliably preserved to all posterity” Henry Oldenburg, 24 November 1664
“...all ingenious men will thereby be incouraged to impact their knowledge and discoverys” Henry Oldenburg, 3 December 1664
“...the 'Philosophical Transactions' be composed by Mr Oldenburg ... being first revised by some of the members.” Royal Society of London, Council Minutes, 1 March 1665

Digital Revolution

same four values:credit, documentation, sharing & participation → open source movement

Version Control Software

more granular attribution and documentation

Free Software & the Web

software and data is availableimmediately and globally

Linus Torvalds’s style of development—release early and often, delegate everything you can, be open to the point of promiscuity—came as a surprise ... the Linux community seemed to resemble a great babbling bazaar of differing agendas and approaches ... out of which a coherent and stable system could seemingly emerge... Eric S. Raymond, The Cathedral and the Bazaar

Open Source

A philosophy of collaboration in which working materials are made available online for anyone to fork, modify, discuss, and contribute to. The GitHub Glossary, Open Source

Mozilla & Open Source

Let's bring this radical participation to science!

Why participate in open source?

hard skills soft skills contribute to something that matters

Open Source project checklist

GitHub - public repository LICENSE - open source README.md - make your mission clear Public issue tracker - good first bugs CONTRIBUTING.md - contributor guidelines Roadmap - development status Mentorship - engage your community

1. GitHub – public repository

Put your work in a public repository!

New to GitHub? http://guides.github.com/

Installing git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git

2. LICENSE - open source

Make sure your project is actually open source

choosealicense.com

3. README.md - make your mission clear

  • First introduction to a project
  • Lead with a clear & concise mission statement

Example Mission

1961: Kennedy announces they will put a man on the moon by the end of the decade

4. Public issue tracker

Tease out the tasks and questions you have

5. CONTRIBUTING.md - contributor guidelines

Let others know how they can help

Questions to answer in your CONTRIBUTING.md

  • How do I report a bug?
  • How do I set up my development environment?
  • How do I submit changes to the code base?
  • Where can I ask for help? – make sure you point users to an IRC channel / forum / email address that will be responsive and welcoming to newcomers.

6. Roadmap - development status

Once you decide what you're going to do, write it down!

7. Mentorship - engage your community

Next Steps

These slides: http://acabunoc.github.io/work-open-webfest

Working Open The Value of Open Source to Science slides: http://acabunoc.github.io/work-open-webfest Abigail Cabunoc Mayes / @abbycabs