Differences between revisions 39 and 55 (spanning 16 versions)
Revision 39 as of 2013-06-20 22:10:55
Size: 5720
Editor: ?CédricBoutillier
Comment: update some info
Revision 55 as of 2021-06-19 14:38:31
Size: 5558
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) = = General Information =
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. All packages are now hosted in the ruby-team group on [[https://salsa.debian.org/ruby-team|Salsa]].
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.
The complete information is spread across this page and the following pages:
[[/Packaging]] [[/Packaging/Conventions]] [[/Packaging/TestFailures]] [[/Packaging/Tests ]]
Line 21: Line 10:
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. == Packages information ==
 * [[http://qa.debian.org/developer.php?login=pkg-ruby-extras-maintainers%40lists.alioth.debian.org&comaint=yes|Packages overview]]
 * [[http://pet.debian.net/pkg-ruby-extras/pet.cgi|PET overview for packages in Git]]
 * [[http://udd.debian.org/dmd.cgi?email1=pkg-ruby-extras-maintainers%40lists.alioth.debian.org|Debian Maintainer Dashboard for the team]]
 * [[https://salsa.debian.org/ruby-team|list of all Git repositories owned by the pkg-ruby-extras team]]
 * [[https://bugs.debian.org/cgi-bin/pkgreport.cgi?dist=unstable;maint=pkg-ruby-extras-maintainers%40lists.alioth.debian.org|bugs reported on packages maitained by the team]]
Line 23: Line 17:
= pkg-ruby-extras team (libraries and applications) = = Joining the Debian Ruby team =
Line 25: Line 19:
 * Documentation (some of the docs might be outdated. Please improve them!)
   * '''[[/Packaging|Team Documentation and current packaging practices]]'''.
   * 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
 * overview of team packages
   * [[http://qa.debian.org/developer.php?login=pkg-ruby-extras-maintainers%40lists.alioth.debian.org&comaint=yes|Packages overview]]
   * [[http://pet.debian.net/pkg-ruby-extras/pet.cgi|PET overview for packages in Git]]
   * [[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]]
== Communication ==
=== Mailing List ===
The general discussion mailing list of Debian Ruby team can be found at https://lists.debian.org/debian-ruby/ . The mailing list is open for anybody to join and post and acts as the central point of access for communication with the Team. To post to the mailing list, send a mail to debian-ruby@lists.debian.org
Line 36: Line 23:
 * [[http://pkg-ruby-extras.alioth.debian.org/wheezy/|Current status]] of the gem2deb transition === IRC ===
   * #debian-ruby on irc.debian.org (OFTC) where team members hang around.
   * #debian-ruby-changes on irc.debian.org (OFTC) for [[Services/KGB|KGB]] notifications.
Line 38: Line 27:
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!
== Salsa ==
This is the server hosting all git repositories maintained by the [[https://salsa.debian.org/ruby-team|ruby-team]].
The repositories are all public.
You can send merge requests for one-shot fixes.
You can also request membership to the group `ruby-team` and wait for an admin to add you to the group.
To speed up the procedure, send an email to the mailing list (debian-ruby@lists.debian.org) stating your request to join the alioth group and preferably the package you intend to maintain under the team.
Line 44: Line 34:
= 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]].
Information about the transition from Alioth to Salsa can be found [[/Salsa|here]].
Line 47: Line 36:
== Keep our packages bug-free and up-to-date ==
<<Icon(star_on.png)>>
Start from the packages overview mentioned above.
= Contributing to the Debian Ruby team =
Line 51: Line 38:
== 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.
If you are a Debian enthusiast with basic Ruby knowledge, you can help Debian Ruby team's activities. There are different ways to contribute to Debian Ruby team, which includes (and is not limited to)
Line 55: Line 40:
== Provide backports ==
<<Icon(star_on.png)>>
Provide backports for the key Ruby packages (interpreter, rubygems) for both Debian and Ubuntu stable releases.
== Identifying and reporting bugs ==
Line 59: Line 42:
== 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.
If you are a user of the packages maintained by Debian Ruby team, you can help us by reporting the bugs you find in the packages using the [[http://bugs.debian.org|Debian Bug Tracker]] or [[https://wiki.debian.org/reportbug|reportbug]] tool. You can also add wishlist bugs about changes/features you would like to be added to the package so as to make it better to use.
Line 62: Line 44:
== 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]]).
== Bug triaging ==
Line 70: Line 46:
== 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.
You can also help to triage bugs, by choosing bugs from https://bugs.debian.org/pkg-ruby-extras-maintainers@lists.alioth.debian.org or https://udd.debian.org/dmd/?email1=pkg-ruby-extras-maintainers%40lists.alioth.debian.org&email2=&email3=&packages=&ignpackages=&format=html#todo, and try to
 1. reproduce them on your local machine / clean chroot as needed
 2. confirm bug's existence and validity
 3. Tag bugs appropriately
 4. Close invalid ones

== Fixing bugs ==

If you have knowledge in Ruby, you can fix bugs that have been filed against the team maintained packages by providing patches and helpful information. Those like FTBFS bugs are often caused by test failures in packages and should be fixed to ensure reproducibility of the packages.

Chances of bugs are more during transition of the Ruby version and any help in identifying, tagging and fixing them are much appreciated.

== Documentation ==

This wiki, and it's subpages are intended to collect all the information regarding the structure, activities and conventions of Debian Ruby team, and needs extensive care and help to be maintained in good, up-to-date state. Start by [[https://wiki.debian.org/FrontPage?action=newaccount|creating an account]] in Debian Wiki and cleaning up the pages to contain only valid, prompt and updated information

== Packaging ==

'''Workflow about packaging new Ruby based software for Debian can be found [[/Packaging|here]].'''

== Maintaining ==

Maintainance of a package involves the tasks like updating a package to the latest version, keeping the package to be in accordance with the current Debian policies and standards etc. To know about updating a package and uploading it, visit here.

== Historical Section ==

Libraries and applications were previously maintained inside the
[[https://alioth.debian.org/projects/pkg-ruby-extras/|pkg-ruby-extras project]]
on Alioth, while the interpreter packages were maintained inside of the
[[https://alioth.debian.org/projects/collab-maint/|collab-maint project]].
These locations are now deprecated.

= Miscellaneous Documentation =
 * [[/InterpreterTransitions | Interpreter Transition Mechanism]] - Steps to follow on updating the version of Ruby interpreters in Debian archives.
 * '''[[/Packaging|Team Documentation and current packaging practices]]'''.
 * Information for upstream developers: [[/RubyExtras/UpstreamDevelopers]], [[/RubyExtras/OnRubygems]]

= Sub Pages =
Sub pages of this documentation can be found below:
<<Navigation(children,30)>>

General Information

The Debian Ruby team maintains Ruby software in Debian. This includes the interpreters, libraries and applications. All packages are now hosted in the ruby-team group on Salsa.

The complete information is spread across this page and the following pages: /Packaging /Packaging/Conventions ?/Packaging/TestFailures /Packaging/Tests

Packages information

Joining the Debian Ruby team

Communication

Mailing List

The general discussion mailing list of Debian Ruby team can be found at https://lists.debian.org/debian-ruby/ . The mailing list is open for anybody to join and post and acts as the central point of access for communication with the Team. To post to the mailing list, send a mail to debian-ruby@lists.debian.org

IRC

  • #debian-ruby on irc.debian.org (OFTC) where team members hang around.
  • #debian-ruby-changes on irc.debian.org (OFTC) for KGB notifications.

Salsa

This is the server hosting all git repositories maintained by the ruby-team. The repositories are all public. You can send merge requests for one-shot fixes. You can also request membership to the group ruby-team and wait for an admin to add you to the group. To speed up the procedure, send an email to the mailing list (debian-ruby@lists.debian.org) stating your request to join the alioth group and preferably the package you intend to maintain under the team.

Information about the transition from Alioth to Salsa can be found here.

Contributing to the Debian Ruby team

If you are a Debian enthusiast with basic Ruby knowledge, you can help Debian Ruby team's activities. There are different ways to contribute to Debian Ruby team, which includes (and is not limited to)

Identifying and reporting bugs

If you are a user of the packages maintained by Debian Ruby team, you can help us by reporting the bugs you find in the packages using the Debian Bug Tracker or reportbug tool. You can also add wishlist bugs about changes/features you would like to be added to the package so as to make it better to use.

Bug triaging

You can also help to triage bugs, by choosing bugs from https://bugs.debian.org/pkg-ruby-extras-maintainers@lists.alioth.debian.org or https://udd.debian.org/dmd/?email1=pkg-ruby-extras-maintainers%40lists.alioth.debian.org&email2=&email3=&packages=&ignpackages=&format=html#todo, and try to

  1. reproduce them on your local machine / clean chroot as needed
  2. confirm bug's existence and validity
  3. Tag bugs appropriately
  4. Close invalid ones

Fixing bugs

If you have knowledge in Ruby, you can fix bugs that have been filed against the team maintained packages by providing patches and helpful information. Those like FTBFS bugs are often caused by test failures in packages and should be fixed to ensure reproducibility of the packages.

Chances of bugs are more during transition of the Ruby version and any help in identifying, tagging and fixing them are much appreciated.

Documentation

This wiki, and it's subpages are intended to collect all the information regarding the structure, activities and conventions of Debian Ruby team, and needs extensive care and help to be maintained in good, up-to-date state. Start by creating an account in Debian Wiki and cleaning up the pages to contain only valid, prompt and updated information

Packaging

Workflow about packaging new Ruby based software for Debian can be found here.

Maintaining

Maintainance of a package involves the tasks like updating a package to the latest version, keeping the package to be in accordance with the current Debian policies and standards etc. To know about updating a package and uploading it, visit here.

Historical Section

Libraries and applications were previously maintained inside the pkg-ruby-extras project on Alioth, while the interpreter packages were maintained inside of the collab-maint project. These locations are now deprecated.

Miscellaneous Documentation

Sub Pages

Sub pages of this documentation can be found below: