Differences between revisions 1 and 28 (spanning 27 versions)
Revision 1 as of 2013-08-17 22:08:23
Size: 578
Comment:
Revision 28 as of 2017-04-29 06:34:30
Size: 4284
Editor: PaulWise
Comment: newcomer is a tag not a usertag
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== Concept == #language en
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[fr/how-can-i-help|Français]]-~
----
The {{{how-can-i-help}}} program hooks into APT to list opportunities for contributions to Debian (like orphaned packages, or bugs tagged 'newcomer') for packages installed locally, after each APT invocation. It can also be invoked directly, and then lists all opportunities for contribution (not just the new ones).
Line 3: Line 6:
We envision a package in Debian that provides a program, {{how-can-i-help}}, that shows you ways you can help Debian. == Installation ==
Line 5: Line 8:
Initially it would be very similar to rc-alert and wnpp-alert. The {{{how-can-i-help}}} program is provided by the {{{how-can-i-help}}} package, which can be installed by the normal means.
Line 7: Line 10:
== Drivers == == Opportunities for contribution ==
Line 9: Line 12:
* Alberto Á. Fuentes (Implementer)
* Asheesh Laroia (Mentor)
Currently, {{{how-can-i-help}}} shows the following opportunities for contribution:
Line 12: Line 14:
== Metrics ==  * Packages where help is needed, including orphaned ones (from WNPP)
 * Bugs suitable for new contributors (tagged 'newcomer')
 * Bugs affecting Debian infrastructure (tagged 'newcomer')
 * Packages removed from Debian 'testing'
 * Packages going to be removed from Debian 'testing'
Line 14: Line 20:
Asheesh, at least, thinks it'll be useful to come up with metrics so we can measure how useful the program is. === WNPP packages ===
There are different kinds of [[WNPP|Work-Needing and Prospective Packages]]:
 * '''Orphaned (O)''': The package is unmaintained, feel free to adopt it. There is usually an older package available, so it can be used as a base for an updated version. Changes would probably include: packaging a more up to date version of an application, updating dependencies or if some dependencies are no longer in archive (and have ceased development) then replacing them with some other shared libraries. Sometimes the URL moves so making changes to the watch file or some other actions are required. Having an Orphaned package made current and fit for the archive could take considerably less work than building a new package from scratch.
Line 16: Line 24:
Possibly useful metrics:
Line 18: Line 25:
 * How often is the program used? (If we know that, we can measure the effect of campaigns to get the word out about the program.)  * '''Request For Adopter (RFA)''': The maintainer is looking for a potential adopter for whatever personal reasons, but is continuing to work on the package still. If you want to adopt it, an e-mail to the current maintainer is considered polite behaviour. Also the old maintainer might be able to share some tips about the package or something else which would help the new maintainer keep it as good as s/he can. There will also be a working package available, so you can base your work on it.


 * '''Intent To Adopt (ITA)''': Someone intends to adopt the package. You could offer your help and possibly make it a team-maintained package. Arguably team-maintained packages could have a longer life in Debian as the workload spreads among the team. There is possibility of fixing bugs and not being burned or de-motivated when you are team-maintaining!

If you need more information about the process of how to go about adopting packages, please refer to the Packaging Tutorial.


=== 'Newcomer' bugs ===

The '''newcomer''' tag indicates bugs that are suitable for folks who are new to the Debian community and are looking for ways to make a contribution.

[[http://bugs.debian.org/cgi-bin/pkgreport.cgi?tag=newcomer|list of bugs tagged newcomer]], [[http://udd.debian.org/bugs.cgi?release=sid&merged=ign&fnewerval=7&flastmodval=7&newcomer=1&sortby=id&sorto=asc|another list]]

''newcomer'' tags can be set using this {{{bts}}}: {{{bts tag 12345 + newcomer}}}

For more information, see the [[BTS/NewcomerTag|longer description]].

== Bugs affecting Debian infrastructure ==

These list includes bugs tagged ''newcomer'' and affecting the part of the Debian infrastructure that uses [[https://www.debian.org/Bugs/pseudo-packages|pseudopackages]] to handle issues.

== Packages removed or going to be removed from Debian testing ==

These are packages affected by RC bugs or other blockers (build failure, missing deps, etc), the maintainer might need help.

== Need help? ==
 * Useful documentation:
  * [[http://www.debian.org/doc/devel-manuals#maint-guide|New maintainers' guide]]
  * [[http://www.debian.org/doc/devel-manuals#packaging-tutorial|Debian Packaging Tutorial]]
 * Email:
  * debian-mentors@lists.debian.org
  * how-can-i-help@packages.debian.org

== Other links ==
 * [[http://qa.debian.org/popcon.php?package=how-can-i-help|popularity contest statistics]]

== TODO list ==
 * The former content on this page was moved to [[how-can-i-help/Ideas|this page]].

Translation(s): English - Français


The how-can-i-help program hooks into APT to list opportunities for contributions to Debian (like orphaned packages, or bugs tagged 'newcomer') for packages installed locally, after each APT invocation. It can also be invoked directly, and then lists all opportunities for contribution (not just the new ones).

Installation

The how-can-i-help program is provided by the how-can-i-help package, which can be installed by the normal means.

Opportunities for contribution

Currently, how-can-i-help shows the following opportunities for contribution:

  • Packages where help is needed, including orphaned ones (from WNPP)
  • Bugs suitable for new contributors (tagged 'newcomer')
  • Bugs affecting Debian infrastructure (tagged 'newcomer')
  • Packages removed from Debian 'testing'
  • Packages going to be removed from Debian 'testing'

WNPP packages

There are different kinds of Work-Needing and Prospective Packages:

  • Orphaned (O): The package is unmaintained, feel free to adopt it. There is usually an older package available, so it can be used as a base for an updated version. Changes would probably include: packaging a more up to date version of an application, updating dependencies or if some dependencies are no longer in archive (and have ceased development) then replacing them with some other shared libraries. Sometimes the URL moves so making changes to the watch file or some other actions are required. Having an Orphaned package made current and fit for the archive could take considerably less work than building a new package from scratch.

  • Request For Adopter (RFA): The maintainer is looking for a potential adopter for whatever personal reasons, but is continuing to work on the package still. If you want to adopt it, an e-mail to the current maintainer is considered polite behaviour. Also the old maintainer might be able to share some tips about the package or something else which would help the new maintainer keep it as good as s/he can. There will also be a working package available, so you can base your work on it.

  • Intent To Adopt (ITA): Someone intends to adopt the package. You could offer your help and possibly make it a team-maintained package. Arguably team-maintained packages could have a longer life in Debian as the workload spreads among the team. There is possibility of fixing bugs and not being burned or de-motivated when you are team-maintaining!

If you need more information about the process of how to go about adopting packages, please refer to the Packaging Tutorial.

'Newcomer' bugs

The newcomer tag indicates bugs that are suitable for folks who are new to the Debian community and are looking for ways to make a contribution.

list of bugs tagged newcomer, another list

newcomer tags can be set using this bts: bts tag 12345 + newcomer

For more information, see the longer description.

Bugs affecting Debian infrastructure

These list includes bugs tagged newcomer and affecting the part of the Debian infrastructure that uses pseudopackages to handle issues.

Packages removed or going to be removed from Debian testing

These are packages affected by RC bugs or other blockers (build failure, missing deps, etc), the maintainer might need help.

Need help?

TODO list

  • The former content on this page was moved to this page.