Differences between revisions 41 and 43 (spanning 2 versions)
Revision 41 as of 2013-07-02 15:03:06
Size: 6360
Editor: ?CédricBoutillier
Comment:
Revision 43 as of 2013-08-25 23:19:25
Size: 2566
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
The '''Debian/Ruby teams''' maintain the Ruby interpreters, libraries and applications. There are actually two different Ruby teams in Debian:
 * the pkg-ruby team, which maintains the interpreter
 * the pkg-ruby-extras team, which maintains libraries and applications

Both teams share some infrastructure, and have common members.

Most discussions happen on the [[http://lists.debian.org/debian-ruby/| debian-ruby mailing list]]. Discussions specific to pkg-ruby-extras also happen on the [[http://lists.alioth.debian.org/mailman/listinfo/pkg-ruby-extras-maintainers | pkg-ruby-extras-maintainers list]]. You should be subscribed to both if you want to follow Ruby in Debian.
We also use '''IRC (#debian-ruby on irc.debian.org)''' quite a lot.
Line 12: Line 3:
= pkg-ruby team (interpreters) = = About the Ruby team =
Line 14: Line 5:
 * Packages are maintained in git using collab-maint. See PTS pages for [[http://packages.qa.debian.org/r/ruby1.8.html|ruby1.8]] and [[http://packages.qa.debian.org/r/ruby1.9.1.html|ruby1.9.1]]. The '''Debian Ruby team''' maintains Ruby software in Debian. This includes the interpreters, libraries and applications.
Line 16: Line 7:
'''How you can help''' (<<Icon(star_on.png)>> indicates difficulty: <<Icon(star_on.png)>>=easy, <<Icon(star_on.png)>><<Icon(star_on.png)>><<Icon(star_on.png)>>=hard):
 * <<Icon(star_on.png)>> Go through bugs, see if you can reproduce them and provide more information. Report them upstream when needed.
 * <<Icon(star_on.png)>> Subscribe to the pkg-ruby packages (ruby1.8, ruby1.9.1, ruby-defaults) on the Packages Tracking System, and then contribute to the bug mail you get. (It is a good idea to also subscribe to bugmail from Ubuntu, see [[http://www.debian.org/doc/developers-reference/resources.html#pts-commands|developers reference]] for details).
 * <<Icon(star_on.png)>><<Icon(star_on.png)>> Checkout the Git repositories, see if you can provide a patch for some issues.
 * Libraries and applications are maintained inside the [[https://alioth.debian.org/projects/pkg-ruby-extras/|pkg-ruby-extras project]].
 * The interpreter packages are maintained inside of the [[https://alioth.debian.org/projects/collab-maint/|collab-maint project]].
 * [[/Jessie|Goals for Debian Jessie]]
Line 21: Line 11:
For all of this, you might need to learn basics of Debian packaging. See [[http://www.debian.org/devel/|this page]] and the packaging-tutorial package. = Get in touch =
Line 23: Line 13:
= pkg-ruby-extras team (libraries and applications) = Mailing lists:
Line 25: Line 15:
 * Documentation (some of the docs might be outdated. Please improve them!)  * [[http://lists.debian.org/debian-ruby/|debian-ruby mailing list]] -- General discussions, sponsorship requests etc
 * [[http://lists.alioth.debian.org/mailman/listinfo/pkg-ruby-extras-maintainers|pkg-ruby-extras-maintainers mailing list]] -- bug reports and other communication targetted at team-maintained packages

IRC: `#debian-ruby` channel on `irc.debian.org`

= How to contribute =

We are currently working on [[/Jessie|several items for the next Debian release]]. There are several items there in need of a volunteer to do it. Feel free to mail the [[http://lists.debian.org/debian-ruby/|team mailing list]] if you need any clarification before contributing to one of those items.

Besides that, there are recurring tasks that can always benefit from more people helping:

 * Improving documentation (this page, the [[Ruby]] page, etc..)
 * Maintainance of the [[http://qa.debian.org/developer.php?login=pkg-ruby-extras-maintainers%40lists.alioth.debian.org&comaint=yes|team packages]], including:
   * bug triaging
   * bug fixing
   * packaging improvements in general

= Documentation and Links =

 * Packaging basics: see the `packaging-tutorial` package
   * `$ apt-get install packaging-tutorial`
Line 27: Line 37:
   * Information for upstream developers: [[/RubyExtras/UpstreamDevelopers]], [[/RubyExtras/OnRubygems]]
   * [[http://lists.debian.org/debian-ruby/|The team mailing lists archives]]
 * Alioth Project: http://alioth.debian.org/projects/pkg-ruby-extras
 * Information for upstream developers: [[/RubyExtras/UpstreamDevelopers]], [[/RubyExtras/OnRubygems]]
Line 33: Line 41:
   * [[http://pkg-ruby-extras.alioth.debian.org/cgi-bin/pet.cgi|PET overview for packages in SVN]] (almost outdated)
* [[http://udd.debian.org/dmd.cgi?email=pkg-ruby-extras-maintainers%40lists.alioth.debian.org|Debian Maintainer Dashboard of the team]]
   * [[http://udd.debian.org/dmd.cgi?email=pkg-ruby-extras-maintainers%40lists.alioth.debian.org|Debian Maintainer Dashboard for the team]]
Line 36: Line 43:
Line 37: Line 45:

How you can help:
 * <<Icon(star_on.png)>> Subscribe to the lists, and start contributing to discussions.
 * <<Icon(star_on.png)>> Improve documentation (that page, the [[/Ruby]] page, etc..
 * <<Icon(star_on.png)>> Use the Packages overview to go through all existing bugs, and see if you can help with solving some of them.
 * <<Icon(star_on.png)>><<Icon(star_on.png)>> Checkout the Git repository, and see if you can improve the existing packages. There are many things that can be improved!

= Easy tasks =

 * Check/correct Vcs/homepage/uscan URL for the packages of the team. Use [[http://duck.debian.net/index.php?searchstring=pkg-ruby-extras|DUCK tool]].
 * Change dependencies of packages from ruby1.8 | ruby-interpreter. This dates from the time where ruby1.8 was the default, and there was no ruby metapackage. To get the list of oaffected packages:
 {{{
 $cd pkg-ruby-extras; grep -R "ruby1.8 |" */debian/control | cut -f1 -d/
 }}}
 or
 {{{
 $apt-cache rdepends ruby1.8 | grep "|"
 }}}

= Mid- and Long-term tasks =
To learn about the recent stuff that happened in Debian/Ruby world, see [[http://www.lucas-nussbaum.net/blog/?p=681|this blog post]].

== Keep our packages bug-free and up-to-date ==
<<Icon(star_on.png)>>
Start from the packages overview mentioned above.

== Finish the transition to gem2deb ==
<<Icon(star_on.png)>>
We are currently transitioning from a cdbs-based packaging tool to gem2deb, a modern dh-based tool. See [[/Packaging]] for details, and the transition status at [[http://pkg-ruby-extras.alioth.debian.org/wheezy/]] and [[http://pkg-ruby-extras.alioth.debian.org/wheezy/details.html]]. Pick up a package tnat needs to be transitioned, and work on it.

== Provide backports ==
<<Icon(star_on.png)>>
Provide backports for the key Ruby packages (interpreter, rubygems) for both Debian and Ubuntu stable releases.

== Deprecate Ruby1.8 ==
<<Icon(star_on.png)>>Since Wheezy, Ruby 1.9.3 has been the default Ruby interpreter in Debian. Upstream support for Ruby 1.8 is about to stop, but some packages still depend on ruby1.8 package. Help track down these packages, file bug reports and send patches.

== Package other Ruby interpreters ==
<<Icon(star_on.png)>><<Icon(star_on.png)>><<Icon(star_on.png)>>
It would be nice to make progress towards having the same support for Rubinius and JRuby.
 * JRuby is now in main (see [[http://packages.qa.debian.org/j/jruby.html|PTS page]]) but is outdated. Contact Java team for possible collaboration?
 * For Rubinius, there's an ITP (see [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=591817|#591817]])
 * mruby has been uploaded in experimental ([[http://packages.qa.debian.org/m/mruby.html|link to PTS]])
 * Work on Ruby2.0 is ongoing (see [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=697703|#697703]]).

== Generation of ri and rdoc documentation ==
<<Icon(star_on.png)>><<Icon(star_on.png)>><<Icon(star_on.png)>>
Currently we do not to generate the ri and rdoc documentation, as there are good online services providing it (like rdoc.info). We might change our mind later. :) Bonus points for solutions that do not require changing the existing packages.

About the Ruby team

The Debian Ruby team maintains Ruby software in Debian. This includes the interpreters, libraries and applications.

Get in touch

Mailing lists:

IRC: #debian-ruby channel on irc.debian.org

How to contribute

We are currently working on several items for the next Debian release. There are several items there in need of a volunteer to do it. Feel free to mail the team mailing list if you need any clarification before contributing to one of those items.

Besides that, there are recurring tasks that can always benefit from more people helping:

  • Improving documentation (this page, the Ruby page, etc..)

  • Maintainance of the team packages, including:

    • bug triaging
    • bug fixing
    • packaging improvements in general

Documentation and Links