NewPackages

Differences between revisions 29 and 56 (spanning 27 versions)
Revision 29 as of 2011-01-18 10:17:28
Size: 8337
Editor: p5DDC09DC
Comment:
Revision 56 as of 2021-06-14 14:41:16
Size: 10246
Editor: ogra
Comment: move to libera.chat
Deletions are marked like this. Additions are marked like this.
Line 12: Line 12:
Packages that have recently been added to Debian unstable will be automatically synced into Ubuntu prior to the [[DebianImportFreeze|Debian Import Freeze (DIF)]]. After the Debian Import Freeze, you will have to [[https://launchpad.net/ubuntu/+filebug|file a bug]] with the summary field "Please sync <packagename> from debian <distro>" where <packagename> is the package you would like to see. Find the date for Debian Import Freeze on [[ReleaseSchedule|the release schedule page]]. Packages that have recently been added to Debian unstable will be automatically synced into Ubuntu prior to the [[DebianImportFreeze|Debian Import Freeze (DIF)]]. After the Debian Import Freeze, you will have to [[https://launchpad.net/ubuntu/+filebug/?no-redirect|file a bug]] with the summary field "Please sync <packagename> from debian <distro>" where <packagename> is the package you would like to see. Find the date for Debian Import Freeze on [[ReleaseSchedule|the release schedule page]].
Line 16: Line 16:
Because we want Free Software to reach as many people as possible and do not want to have too much duplication of packaging effort, it is useful for packages that meet the requirements of the [[http://www.debian.org/social_contract#guidelines | Debian Free Software Guidelines]] to be requested within Debian's [[http://www.debian.org/devel/wnpp/ | Work-Needing and Prospective Packages]] (WNPP) process by filing a Request for Package (RFP) but on the WNPP package in Debian's bugtracker. If you file a needs-packaging bug, please link it to the Debian WNPP bug as well. Because we want Free Software to reach as many people as possible and do not want to have too much duplication of packaging effort, it is useful for packages that meet the requirements of the [[http://www.debian.org/social_contract#guidelines | Debian Free Software Guidelines]] to be requested within Debian's [[http://www.debian.org/devel/wnpp/ | Work-Needing and Prospective Packages]] (WNPP) process by filing a Request for Package (RFP) bug on the WNPP package in Debian's bugtracker. If you file a needs-packaging bug, please link it to the Debian WNPP bug as well.
Line 20: Line 20:
You can follow the [[PackagingGuide/Basic | Packaging Guide directives]]. You can follow the [[http://packaging.ubuntu.com/html/ | Packaging Guide directives]].

To get a screenshot included for software-center, please use http://screenshots.debian.net/upload
Line 24: Line 26:
Ubuntu regularly incorporates source packages from Debian, so it is encouraged to upload a package to Debian first to automatically have it in Ubuntu in due time. In order to have faster reviews, several teams have been set up to manage a given subset of packages. Some of them are: Ubuntu regularly incorporates source packages from Debian, so it is encouraged to upload a package to Debian first to automatically have it in Ubuntu in due time. In addition to that your package will reach a much broader audience if it is in Debian and all of its derivatives.


In order to have faster review
s, several teams have been set up to manage a given subset of packages. Some of them are:
Line 36: Line 41:
 * [[http://pkg-xorg.alioth.debian.org/| Debian X Team]]
Line 37: Line 43:
More teams can be found [[http://wiki.debian.org/Teams|here]]. More teams can be found [[http://wiki.debian.org/Teams|here]]. If there is no team available that takes care of the group of packages you are interested in, contact the Debian mentors (look below).
Line 39: Line 45:
Ubuntu does virtually all package maintenance in teams. If you have a deep interest in a particular package and a desire to be the primary person responsible for it, you would likely be happier to get the package into Debian and maintain it there. Debian has a strong culture around individual package maintainers that is not present in Ubuntu. Additionally there are roughly an order of magnitude more Debian Developers than Ubuntu developers. It is quite difficult to get a new package into Ubuntu due to the shear volume of requests compared to the available resources for reviews. In many cases people have an easier time getting their package into Ubuntu via Debian than directly. Ubuntu does virtually all package maintenance in teams. If your package is related to any of the existing teams within Debian, work with that team to get the package uploaded to Debian. If there is no team already, you should consider starting a new team within Debian (e.g. at Alioth) for any package which is likely to have a significant number of bugs or other maintenance overheads (like architecture-specific issues).
Line 41: Line 47:
If you choose to do this, file an Intent to Package (ITP) bug on the WNPP package in Debian to let others know that you're working on it, then go through the [[http://mentors.debian.net/cgi-bin/welcome | Debian Mentors]] to get the package uploaded. A number of Ubuntu Developers are also Debian Maintainers or Debian Developers, so they may be able to help you navigate Ubuntu/Debian interactions. Additionally there are roughly an order of magnitude more Debian Developers than Ubuntu developers. It is quite difficult to get a new package into Ubuntu due to the shear volume of requests compared to the available resources for reviews. In many cases people have an easier time getting their package into Ubuntu via Debian than directly.

If you choose to do this, file an Intent to Package ([[http://www.debian.org/devel/wnpp/being_packaged|ITP]]) bug on the WNPP package in Debian to let others know that you're working on it (`reportbug -B debian wnpp` should do the right thing), then go through the [[http://mentors.debian.net/cgi-bin/welcome | Debian Mentors]] to get the package uploaded. A number of Ubuntu Developers are also Debian Maintainers or Debian Developers, so they may be able to help you navigate Ubuntu/Debian interactions.

Good tips:
 * Follow [[http://www.debian.org/doc/manuals/developers-reference/pkgs.html#newpackage|the procedures]] to get a [[http://ftp-master.debian.org/new.html|new package]] into Debian.
 * Subscribe to bugs of the package once it is accepted.
Line 45: Line 57:
Packages which are not in Ubuntu yet, require extra scrutiny and go through a special review process, before they get uploaded and get a final review by the [[http://launchpad.net/~ubuntu-archive|archive admins]]. More information on the review process, including the criteria which will be applied, can be found on the [[UbuntuDevelopment/CodeReviews#NewPackage|Code Reviewers page]]. Developers are encouraged to examine their own packages using these guidelines prior to submitting them for review. Submitting new packages through Debian is the preferred path. But, if your package is Ubuntu-specific or can't go into Debian for some other reason, you can submit it directly to MOTU. There are a limited number of available reviewers, so you may encounter delays here.

New packages
require extra scrutiny and go through a special review process, before they get uploaded and get a final review by the [[http://launchpad.net/~ubuntu-archive|archive admins]]. More information on the review process, including the criteria which will be applied, can be found on the [[UbuntuDevelopment/CodeReviews#NewPackage|Code Reviewers page]]. Developers are encouraged to examine their own packages using these guidelines prior to submitting them for review.
Line 50: Line 64:
 * New MOTU contributors (who are not members of the [[https://launchpad.net/~motu|MOTU]] team yet), need to get their packages reviewed and signed off by two [[https://launchpad.net/~ubuntu-dev/+members|Ubuntu Developers]] to get them uploaded to Ubuntu.  * New MOTU contributors (who are not members of the [[https://launchpad.net/~motu|MOTU]] team yet), need to get their packages reviewed and signed off by two [[https://launchpad.net/~motu/+members|MOTUs (core-devs are included in this)]] to get them uploaded to Ubuntu.
Line 54: Line 68:
 * When you start to work on a new package, assign the needs-packaging bug to yourself and set it In Progress (if there is no needs-packaging bug, file one).
 * Once you have an initial package, upload it to [[MOTU/Packages/REVU|REVU]], add the link to the package in [[MOTU/Packages/REVU|REVU]] to the description of the bug. From this point on, no further Launchpad entries are made until the package is uploaded.
 * Join the #ubuntu-motu channel on irc.libera.chat and talk with the MOTU. It's good to do this early on, to get advice on how to package (avoid common mistakes), to find out if your package is likely to be accepted (before you invest a lot of work in packaging it), and to find mentors willing to sponsor your package or to point you in the right direction.
 * When you start to work on a new package, assign the needs-packaging bug to yourself and set it In Progress (if there is no needs-packaging bug, [[http://bugs.launchpad.net/ubuntu/+filebug?no-redirect&field.tag=needs-packaging|file one]]).
 * Once you have an initial package, follow the [[http://packaging.ubuntu.com/html/packaging-new-software.html#next-steps|new packaging instructions]] to upload it to your PPA or a Launchpad branch, then add a link to the package in the description of the bug. Requests for changes or other communication about your package will be made as comments on your bug. Subscribing ubuntu-sponsors to sponsorship requests is generally advised, as it makes the request appear on the list that people look at.
Line 61: Line 76:
 * Even if you don't run Debian as your primary OS, most packaging can be tested perfectly well in a chroot, or failing that in a VM (and most packages will work fine without any changes anyway). (→ [[UsingDevelopmentReleases]])
 * #debian-ubuntu on OFTC and the [[http://lists.debian.org/debian-derivatives/|debian-derivatives mailing list]] are good places for Ubuntu developers to ask their questions.

Line 63: Line 82:
[[FeatureFreeze|Feature Freeze]] is the latest approval date (August 12th for "Maverick" aka Ubuntu 10.10): it is recommended to get things done in a couple weeks earlier, as getting approval may take some time.
REVU days are planned through Feature Freeze, but the last days are likely only to grab packages that are really required to meet the feature goals for the release.

=== Alternative workflows ===
 * These are permitted, but [[MOTU/Packages/REVU|REVU]] is the official location for getting packages reviewed.
 * The key policy point is that two MOTUs must advocate the package. Most MOTUs use [[MOTU/Packages/REVU|REVU]] and it may be more difficult to get packages in alternative locations reviewed.
[[FeatureFreeze|Feature Freeze]] is the latest approval date, it is recommended to get things done in a couple of weeks earlier, as getting approval may take some time.
Line 72: Line 86:
 * [[http://mentors.debian.net/|mentors.debian.net]], a website where people interested in getting their packages inside Debian can upload their packages. You need to [[http://mentors.debian.net/debian/pool/|browse the directories]] to find packages. ContributingToDebian has additional information on getting your work into Debian.
 * [[http://svn.debian.org/wsvn|Debian's WebSVN]] It's possible that a package has been worked on for Debian but has a status of UNRELEASED. Check the appropriate directories that begin with "pkg" that your package may fall under. For example, game packages would be under "pkg-games".
 * [[http://mentors.debian.net/|mentors.debian.net]], a website where people interested in getting their packages inside Debian can upload their packages. You need to [[http://mentors.debian.net/debian/pool/|browse the directories]] to find packages. ContributingToDebian has additional information on getting your work into Debian. (→ [[http://wiki.debian.org/DebianMentorsFaq|FAQ]])
 * [[https://salsa.debian.org/|Debian's SCM]] - It's possible that a package has been worked on for Debian but has a status of UNRELEASED. Check the appropriate directories that begin with "pkg" that your package may fall under. For example, game packages would be under "pkg-games". [[http://packages.qa.debian.org/common/index.html|The Debian Package Tracking System]] will help you find the specific branch where the package is being maintained.

Criteria

In order for a piece of software to be included in Ubuntu, it must meet the Ubuntu License Policy.

Requesting a new package for Ubuntu

Packages that have recently been added to Debian unstable will be automatically synced into Ubuntu prior to the Debian Import Freeze (DIF). After the Debian Import Freeze, you will have to file a bug with the summary field "Please sync <packagename> from debian <distro>" where <packagename> is the package you would like to see. Find the date for Debian Import Freeze on the release schedule page.

To get a package into Ubuntu, please file a bug in Launchpad and make sure it has the tag needs-packaging. Please mention where to get the source for it and which license it is under. An example request is here. Make sure you check which packages have already been requested.

Because we want Free Software to reach as many people as possible and do not want to have too much duplication of packaging effort, it is useful for packages that meet the requirements of the Debian Free Software Guidelines to be requested within Debian's Work-Needing and Prospective Packages (WNPP) process by filing a Request for Package (RFP) bug on the WNPP package in Debian's bugtracker. If you file a needs-packaging bug, please link it to the Debian WNPP bug as well.

Packaging it yourself

You can follow the Packaging Guide directives.

To get a screenshot included for software-center, please use http://screenshots.debian.net/upload

NEW packages through Debian

Ubuntu regularly incorporates source packages from Debian, so it is encouraged to upload a package to Debian first to automatically have it in Ubuntu in due time. In addition to that your package will reach a much broader audience if it is in Debian and all of its derivatives.

In order to have faster reviews, several teams have been set up to manage a given subset of packages. Some of them are:

More teams can be found here. If there is no team available that takes care of the group of packages you are interested in, contact the Debian mentors (look below).

Ubuntu does virtually all package maintenance in teams. If your package is related to any of the existing teams within Debian, work with that team to get the package uploaded to Debian. If there is no team already, you should consider starting a new team within Debian (e.g. at Alioth) for any package which is likely to have a significant number of bugs or other maintenance overheads (like architecture-specific issues).

Additionally there are roughly an order of magnitude more Debian Developers than Ubuntu developers. It is quite difficult to get a new package into Ubuntu due to the shear volume of requests compared to the available resources for reviews. In many cases people have an easier time getting their package into Ubuntu via Debian than directly.

If you choose to do this, file an Intent to Package (ITP) bug on the WNPP package in Debian to let others know that you're working on it (reportbug -B debian wnpp should do the right thing), then go through the Debian Mentors to get the package uploaded. A number of Ubuntu Developers are also Debian Maintainers or Debian Developers, so they may be able to help you navigate Ubuntu/Debian interactions.

Good tips:

Going through MOTU

Submitting new packages through Debian is the preferred path. But, if your package is Ubuntu-specific or can't go into Debian for some other reason, you can submit it directly to MOTU. There are a limited number of available reviewers, so you may encounter delays here.

New packages require extra scrutiny and go through a special review process, before they get uploaded and get a final review by the archive admins. More information on the review process, including the criteria which will be applied, can be found on the Code Reviewers page. Developers are encouraged to examine their own packages using these guidelines prior to submitting them for review.

To receive higher quality bug reports write an apport hook for your package.

The MOTU team approval policy for new packages:

  • New MOTU contributors (who are not members of the MOTU team yet), need to get their packages reviewed and signed off by two MOTUs (core-devs are included in this) to get them uploaded to Ubuntu.

  • MOTUs can upload new packages directly to the archive. However they are greatly encouraged to have a new package reviewed prior to uploading. (cf. MOTU/Council/Meetings/2007-02-23)

The MOTU team uses the following workflow:

  • Join the #ubuntu-motu channel on irc.libera.chat and talk with the MOTU. It's good to do this early on, to get advice on how to package (avoid common mistakes), to find out if your package is likely to be accepted (before you invest a lot of work in packaging it), and to find mentors willing to sponsor your package or to point you in the right direction.
  • When you start to work on a new package, assign the needs-packaging bug to yourself and set it In Progress (if there is no needs-packaging bug, file one).

  • Once you have an initial package, follow the new packaging instructions to upload it to your PPA or a Launchpad branch, then add a link to the package in the description of the bug. Requests for changes or other communication about your package will be made as comments on your bug. Subscribing ubuntu-sponsors to sponsorship requests is generally advised, as it makes the request appear on the list that people look at.

  • Once the approved package is uploaded, the uploading MOTU will set the bug status to Fix Committed.
  • When the package clears the NEW queue it will automatically be set to Fix Released (debian/changelog must close the needs-packaging bug). This is done with a bullet point that follows the format:

  * Initial release (LP: #242910)
  • where "LP" refers to "Launchpad". See the Packaging Guide for more information on changelogs.

  • Even if you don't run Debian as your primary OS, most packaging can be tested perfectly well in a chroot, or failing that in a VM (and most packages will work fine without any changes anyway). (→ UsingDevelopmentReleases)

  • #debian-ubuntu on OFTC and the debian-derivatives mailing list are good places for Ubuntu developers to ask their questions.

Deadline

Feature Freeze is the latest approval date, it is recommended to get things done in a couple of weeks earlier, as getting approval may take some time.

Also of interest

  • Always check if there is an ITP (intent to package) bug filed against the wnpp package in Debian. That means, somebody is already working on packaging the software for Debian. Join forces with them rather than reinventing the wheel.

  • mentors.debian.net, a website where people interested in getting their packages inside Debian can upload their packages. You need to browse the directories to find packages. ContributingToDebian has additional information on getting your work into Debian. (→ FAQ)

  • Debian's SCM - It's possible that a package has been worked on for Debian but has a status of UNRELEASED. Check the appropriate directories that begin with "pkg" that your package may fall under. For example, game packages would be under "pkg-games". The Debian Package Tracking System will help you find the specific branch where the package is being maintained.


Go back to UbuntuDevelopment.
CategoryProcess
CategoryUbuntuDevelopment

UbuntuDevelopment/NewPackages (last edited 2021-06-14 14:41:16 by ogra)