Getting Started OpenSource: Difference between revisions

From Free Geek Seattle
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 2: Line 2:


Notes for talk at [[SeaGL]] 2015
Notes for talk at [[SeaGL]] 2015
'''working in DocBook, will put github link here'''
https://github.com/koanhead-fgsea/howto-contrib


=Getting Started with Free Libre Open Source Projects=
=Getting Started with Free Libre Open Source Projects=


Since we're at this conference, we probably all are involved in Free Software or Open Source projects to some degree, even if only as users. Lots of us want to help, but it's hard to know where to start!
Since we're at this conference, we probably all are involved in Free Software or Open Source projects to some degree, even if only as users. Lots of us want to help, but it's hard to know where to start!
In this talk we'll look at some common tools and processes prerequisite for involvement in most Open Source or Free Software projects, including but not limited to the following:
In this talk we'll look at some common tools and processes prerequisite for involvement in most Open Source or Free Software projects. This talk focuses heavily on the Debian Project for examples, with some explication of how Debian is different from other projects.


==Introduction: FLOSS contribution is like Social Media writ large==
==Introduction: FLOSS contribution is like Social Media writ large==
Line 15: Line 20:
====BTS: what it is and how it works====
====BTS: what it is and how it works====


bugs.debian.org - all email based, embraces _all_ issues in Debian IBNLT:
bugs.debian.org - all email based, embraces ''all'' issues in Debian IBNLT:


* Bugs in programs
* Bugs in programs
Line 30: Line 35:
===Code monkeying===
===Code monkeying===


==Communication:==
==Communication==
Introduction to GPG and its various uses incl. the Debian Keyring.
===Introduction to GPG and its various uses incl. the Debian Keyring.===
Email lists, joining vs following via NNTP gateway vs gmane or other Web gateway; list etiquette
 
===Email lists===
joining vs following via NNTP gateway vs gmane or other Web gateway; list etiquette
===Chat===
How to IRC; why to IRC; why IRC is still a thing when $FLASHY_NEW_CHAT_APP is *clearly* superior
How to IRC; why to IRC; why IRC is still a thing when $FLASHY_NEW_CHAT_APP is *clearly* superior



Latest revision as of 15:07, 11 October 2015


Notes for talk at SeaGL 2015

working in DocBook, will put github link here

https://github.com/koanhead-fgsea/howto-contrib


Getting Started with Free Libre Open Source Projects[edit]

Since we're at this conference, we probably all are involved in Free Software or Open Source projects to some degree, even if only as users. Lots of us want to help, but it's hard to know where to start! In this talk we'll look at some common tools and processes prerequisite for involvement in most Open Source or Free Software projects. This talk focuses heavily on the Debian Project for examples, with some explication of how Debian is different from other projects.

Introduction: FLOSS contribution is like Social Media writ large[edit]

Ways to Contribute:[edit]

Bug crushing[edit]

BTS: what it is and how it works[edit]

bugs.debian.org - all email based, embraces all issues in Debian IBNLT:

  • Bugs in programs
  • Desired features in programs
  • Declarations of intent (i.e. ITP reports)
  • Policy and process

rt.bestpractical.com - Request Tracker is a common Open Source bugtracker

Web-based frontend with email interface

Documentation[edit]

Media assets[edit]

Code monkeying[edit]

Communication[edit]

Introduction to GPG and its various uses incl. the Debian Keyring.[edit]

Email lists[edit]

joining vs following via NNTP gateway vs gmane or other Web gateway; list etiquette

Chat[edit]

How to IRC; why to IRC; why IRC is still a thing when $FLASHY_NEW_CHAT_APP is *clearly* superior

Programming[edit]

How to read source code How to find problems How to make patches Why VCS is important and how to do it (not the *only* way) TIMTOWTDI vs. TIOOWTDI and other Holy Wars and Crusades, and how to remain unbloodied.

Collaboration[edit]

Finding help / mentors / mentees Submitting patches How to be a good VCS citizen

Why do it?[edit]

What's in it for me?[edit]

What you will need[edit]

How it works[edit]