Skip to content

Commit 64f8eeb

Browse files
committed
Tired.
1 parent 5bd69ea commit 64f8eeb

3 files changed

+17
-9
lines changed

blog/The_Contributor_Competition-unstyled.html

+6-3
Original file line numberDiff line numberDiff line change
@@ -79,8 +79,9 @@ <h2 id="the-problem">The problem</h2>
7979
conversations with the maintainers to the effect of "We have a long list
8080
of good first issues, why is nobody picking them up? We have like three
8181
hundred of them! Fix our type inference bugs! Debug our segfaults! Why
82-
are there no new contributors?" They forget that nobody wants to do
83-
that. People have their own problems to deal with.</p>
82+
are there no new contributors? They should be cleaning up after us!"
83+
They forget that nobody wants to do that. People have their own problems
84+
to deal with.</p>
8485
<h2 id="the-solution">The Solution</h2>
8586
<hr>
8687
<p>    The solution is to drastically lower the barrier to entry while
@@ -114,7 +115,9 @@ <h1 id="actionable-advice.">Actionable advice.</h1>
114115
compiler engineering is going to understand what a phi node or a
115116
dominance frontier is. If you want contributors, then this is
116117
unacceptable. At very least, point to resources that can be consumed in
117-
&lt; 15 minutes.</p></li>
118+
&lt; 15 minutes. If it doesn't exist, then write it yourself. No single
119+
problem is so complicated that it takes more than 15 minutes to explain.
120+
If it does, then it can be broken up.</p></li>
118121
<li><p>APIs should be self documenting, but you should document them
119122
anyway. Exhaustively. You can do this with LLMs, they're very good at
120123
it. If it's python, add type annotations. Not as a tool for

blog/The_Contributor_Competition.html

+6-3
Original file line numberDiff line numberDiff line change
@@ -329,8 +329,9 @@ <h2 id="the-problem">The problem</h2>
329329
conversations with the maintainers to the effect of "We have a long list
330330
of good first issues, why is nobody picking them up? We have like three
331331
hundred of them! Fix our type inference bugs! Debug our segfaults! Why
332-
are there no new contributors?" They forget that nobody wants to do
333-
that. People have their own problems to deal with.</p>
332+
are there no new contributors? They should be cleaning up after us!"
333+
They forget that nobody wants to do that. People have their own problems
334+
to deal with.</p>
334335
<h2 id="the-solution">The Solution</h2>
335336
<hr>
336337
<p>    The solution is to drastically lower the barrier to entry while
@@ -364,7 +365,9 @@ <h1 id="actionable-advice.">Actionable advice.</h1>
364365
compiler engineering is going to understand what a phi node or a
365366
dominance frontier is. If you want contributors, then this is
366367
unacceptable. At very least, point to resources that can be consumed in
367-
&lt; 15 minutes.</p></li>
368+
&lt; 15 minutes. If it doesn't exist, then write it yourself. No single
369+
problem is so complicated that it takes more than 15 minutes to explain.
370+
If it does, then it can be broken up.</p></li>
368371
<li><p>APIs should be self documenting, but you should document them
369372
anyway. Exhaustively. You can do this with LLMs, they're very good at
370373
it. If it's python, add type annotations. Not as a tool for

blog/The_Contributor_Competition.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -82,8 +82,8 @@ them, or offer some other incentive. Nobody wants to clean up your mess for you.
8282
    I consider Julia to be a cautionary tale. I've had multiple conversations with the
8383
maintainers to the effect of "We have a long list of good first issues, why is nobody
8484
picking them up? We have like three hundred of them! Fix our type inference bugs! Debug
85-
our segfaults! Why are there no new contributors?" They forget that nobody wants to do
86-
that. People have their own problems to deal with.
85+
our segfaults! Why are there no new contributors? They should be cleaning up after us!"
86+
They forget that nobody wants to do that. People have their own problems to deal with.
8787

8888

8989
## The Solution
@@ -121,7 +121,9 @@ somewhere prominent. This should be as frictionless as possible.
121121
Julia example, nobody without a Master's degree in compiler engineering is going to
122122
understand what a phi node or a dominance frontier is. If you want contributors, then
123123
this is unacceptable. At very least, point to resources that can be consumed in < 15
124-
minutes.
124+
minutes. If it doesn't exist, then write it yourself. No single problem is so
125+
complicated that it takes more than 15 minutes to explain. If it does, then it can be
126+
broken up.
125127

126128
3. APIs should be self documenting, but you should document them anyway. Exhaustively.
127129
You can do this with LLMs, they're very good at it. If it's python, add type

0 commit comments

Comments
 (0)