members asra, horkley, lujan
[wiki.git] / learn.mdwn
1 How does one "get involved with a SIPB project"? I’ve had countless prospective SIPB members ask me this question, but I have never really had a good answer for them. It’s a complicated, ill-defined process that even recent new members have difficulty describing. Even worse, no two people ever have the same experience, and what worked for one person may not work for another.
2
3 This essay is an attempt to describe this process. Not as a series of step-by-step instructions, because such a recipe doesn’t exist, but as a philosophy, an identification of a mindset that will get you asking the right questions, talking to the right people, and working on the right problems. We’ll take the huge task “Get involved with a SIPB project”, and continually divide it into smaller, more well-defined problems, until we are left with tasks that you can tackle head-on.
4
5 Let’s get started.
6
7 You may also be interested in this document: https://etherpad.mozilla.org/process
8
9 Level 0: Motivation
10 -------------------
11
12 How do you pick a SIPB project to contribute to?  One way to look at this problem is finding a project whose goals and community align with yours, so that contributing to the project is engaging and fun.
13
14 * Does the project solve a problem that you also want to solve?
15
16 * Does the project offer opportunities to learn technical skills that you would like to acquire?
17
18 * Does the project have a good way for you to start contributing, e.g. it is written in a programming language you already know or want to learn, or it is running a system you have some familiarity with?
19
20 Level 0: Milestones
21 -------------------
22
23 What does it mean to have joined a project?  The most important aspects are soft and hard to quantify, but there are some hard and unambiguous technical milestones you can achieve.  Most projects have the following two:
24
25 * Commit access (or “commit bits”), which indicate that you have permission to directly push source code changes to the repository of the project.
26
27 * Administrative access (also called “root bits” or just “root”), which indicate that you have access to the ``root`` account on production hardware and can install software, do system maintenance, etc.
28
29 On some projects, commit bits is equivalent to root, while on other projects, you may be able to commit code, but cannot deploy it without root.
30
31 But even if you don’t have commit access, your level of involvement can vary. As you become more involved with the project, you will start to be able to check off more things off this list:
32
33 * Do you know all of the maintainers involved with the project?
34
35 * Can you describe the project to an interested outsider?
36
37 * Have you used the project yourself as an enduser?
38
39 * Do you know (roughly) what all of the components of the project do?
40
41 * Have you setup an instance of the project’s software and/or configuration from scratch?
42
43 * Have you answered a user question?
44
45 * Have you submitted a patch and gotten it accepted?
46
47 * Have you written documentation for the project?
48
49 * Have you discovered a security vulnerability in the project?
50
51 * Do the project maintainers trust you?
52
53 * (probably more)
54
55 All of these exercise different dimensions of involvement with the project, and you don’t have to do all of them to get root! But there are a lot of ways to contribute without having bits, so don’t get discouraged if you haven’t gotten them yet.
56
57 Level 1: Getting in touch
58 -------------------------
59
60 The single most important first step is setting up lines of communication with the current set of project maintainers.  This can be tricky, because in general every project has a different preferred medium of communication, and a different set of social conventions around this medium.
61
62 ...
63
64 Level 1: Fixing bugs
65 --------------------
66
67 Level 1: Helping users
68 ----------------------
69
70 Level 1: Writing new software
71 -----------------------------
72
73 Level 1: System administration
74 ------------------------------
75
76 Level 2: Learning infrastructure
77 --------------------------------
78
79 Level 2: Identifying problems
80 -----------------------------
81
82 Level 2: Understanding problems
83 -------------------------------
84
85 Level 2: Getting code
86 ---------------------
87
88 Level 2: Navigating code
89 ------------------------
90
91 Level 2: Modifying code
92 -----------------------
93
94 Level 2: Running code
95 ---------------------
96
97 Level 2: Submitting code
98 ------------------------