how-can-i-help post: improve style and content
authorStefano Zacchiroli <zack@upsilon.cc>
Mon, 10 Feb 2014 15:07:06 +0000 (16:07 +0100)
committerStefano Zacchiroli <zack@upsilon.cc>
Mon, 10 Feb 2014 15:07:06 +0000 (16:07 +0100)
blog/posts/2014/02/apt-get_install_how-can-i-help.mdwn

index ead5aa3..fe0e8d0 100644 (file)
@@ -1,33 +1,42 @@
 # skyrocketing how-can-i-help popcon count
 
 [**how-can-i-help**](http://packages.debian.org/sid/how-can-i-help) by Lucas
-Nussbaum is one of the best things that happened in the field of **attracting
-contributions to Debian** in quite a while.
-
-how-can-i-help is great for **newbies** who are looking for a way to give back
-to Debian based on their abilities — among other things, how-can-i-help shows
-new [bugs tagged "gift"](https://wiki.debian.org/qa.debian.org/GiftTag) on
-packages you use.  But how-can-i-help is also great for **experienced
-developers**, as it allows them to find out, in a timely manner, that packages
-they use is in dire need of help: RC bug fixing, adoption, sponsoring, etc.
-
-If you haven't installed it yet, please do so RIGHT NOW. It's as easy as:
-
-    apt-get install how-can-i-help
-
-I think we should aim at **installing how-can-i-help by default** on all Debian
-machines, but that might be an ambitious goal in terms of dependencies. In the
-meantime, I'll settle for making how-can-i-help's **popcon count**
-skyrocket. As of today, it looks like this:
+Nussbaum is one of the best things that happened in the area of **attracting
+contributions to Debian** in quite a while. It can be used both as a standalone
+tool to list opportunities for contributing to Debian which are related to your
+installed packages, and as an APT hook (which is also the default
+configuration) that at each upgrade will inform you of *new* contribution
+opportunities.
+
+how-can-i-help is **great for newbies** who are looking for ways to give back
+to Debian which are a good match for their skills: among other things,
+how-can-i-help shows
+[bugs tagged "gift"](https://wiki.debian.org/qa.debian.org/GiftTag) related to
+packages you use.
+
+how-can-i-help is also great for **experienced developers**, as it allows them
+to find out, in a timely manner, that packages they use are in dire need of
+help: RC bugs, pending removals, adoptions needed, requests for sponsor, etc.
+<small>(As highly unscientific evidence: I've noticed a rather quick turnover
+of RFA/O/ITA bugs on packages installed on my machine. I suspect how-can-i-help
+is somehow responsible for that, due to the fact that it increases awareness of
+ongoing package issues directly with the people *using* them.)</small>
+
+So, if you haven't yet, please `apt-get install how-can-i-help` RIGHT NOW.
+
+I daresay that we should aim at **installing how-can-i-help by default** on all
+Debian machines, but that might be an ambitious initial goal. In the meantime
+I'll settle for making how-can-i-help's **popcon count** skyrocket. As of
+today, it looks like this:
 
 [[!img how-can-i-help-popcon-20141002.png
   link="http://qa.debian.org/popcon.php?package=how-can-i-help"
   alt="how-can-i-help popularity contest graph, 10/02/2014"]]
 
-which is definitely too low. Please **spread the word** about how-can-i-help,
-and we'll see what happens to that graph!
+which is definitely too low for my taste. Please **spread the word** about
+how-can-i-help. And let's see what we can collectively do to that graph.
 
-how-can-i-help is just a tiny teeny helper, but I'm convinced it could do
-wonder in unleashing currently dormant contributions to the Debian Project.
+how-can-i-help is just a tiny teeny helper, but I'm convinced it can do wonders
+in liberating dormant contributions to the Debian Project.
 
 [[!tag lang/english planet-debian howcanihelp debian draft]]