Post Release Application Submission Process
THIS DOCUMENT IS IN DEVELOPMENT BY jono AT ubuntu DOT com - THIS IS NOT FINAL.
The purpose of this document is to outline the process where by applications can be submitted to a community-driven evaluation board for review
The current Ubuntu process for getting an application into an Ubuntu archive is slow and complex and unapproachable for application authors. This complexity of process is preventing application authors from making their software available in Ubuntu.
The high-level solution is to provide a facility in which application authors can propose their application for inclusion in the Ubuntu Software Center. This inclusion can happen at any time (including post-release).
The process for submitting an application has three primary stages:
- Preparation - get your application packaged and available for assessment.
- Submission - submit the package to be reviewed for inclusion in the software center.
- Assessment - the assessment process in which our Application Review Board decided whether the application is admitted to the software center.
Each stage is broken down in a series of components, as illustrated below:
I will now outline each of these different stages.
This step prepares the application ready for assessment by the Application Review Board.
This step has two components:
Package the application - package the application ready to be installed and run.
The application should be packaged using the standard Debian packaging system. Documentation for this process is in the Packaging Guide (https://wiki.ubuntu.com/PackagingGuide).
Upload to a PPA - the package is uploaded to the user's PPA
- The package is reviewed from the PPA.
The second step is for the developer to formulate a submission to present the application, supplying additional information about the application to the Application Review Board.
The data to be gathered in this process is:
- Name (text)
- Email (text)
- Package to be assessed (URL to PPA)
- License (text)
- Support contact (URL to forum / mailing list etc)
- Notes (text with information pertinent to the assessment)
- Optional: Bug tracker (URL)
To file an application, the following process is executed.
- User uses the pre-defined template (outlined below) and provides all required content.
This filled-out template is emailed to app-reviews AT ubuntu DOT com. This mailing list is a read-only queue to receive applications.
- The application review appears in the email moderation queue for the Application Review Board.
The third step is the assessment process. This step requires the Application Review Board (ARB). The board has the following attributes:
- 5 - 7 people
- Appointed by the CC/TB
- 1 year term
- Everyone welcome to nominate themselves for positions.
- Report to the CC.
For details of the structure of this board, see the 'Application Review Board Codification' section below.
The review process requires an assessment of the application and at least one (1) code review by a member of the ARB. The review process assesses the application against the following criteria:
Packaging - is the application well packaged, using the Debian packaging system? Are it's dependencies met? Does it install cleanly? Does it remove cleanly? Does it include suitable Copyright and licensing content?
Integration - does the application integrate into the Applications menu?
Run Test - does the application run? Does it's major features operate as expected?
Acceptable Content - does the application include family-friendly end-user content?
The ARB receives notifications of applications for review via the mailing list and reviews the wiki page that is available from the submission step above. The process in which it is reviewed is:
- The assessment process is performed over email to reduce bottle-necks surrounding real-time IRC meetings.
- We should commit to an SLA regarding the outcome of the review. My recommendation would be two weeks.
- The review happens by the ARB reviewing the application wiki page and voting on their support of the application.
- The outcome of the vote is:
- Three or more +1 votes - the application is approved.
- If there are more than one -1 votes - the application is discussed in more detail and possibly deferred.
- Three or more -1 votes - the application is rejected.
- Documented guidelines about how the assessment process works.
Application Submission Template
Below is the official template that application authors should use when requesting an application to be reviewed by the ARB:
Request For Application Review ------------------------------ This email provides information required for an application review. About You: NAME: EMAIL ADDRESS: The Application: APPLICATION NAME: LICENSE: PPA URL: SUPPORT RESOURCE (URL to forum / mailing list etc) KNOWN ISSUES: * Issue. * Issue. Please add additional notes about this application review below:
Application Review Board Codification
This document aims to:
- Provide a clear delegation and codification of how applications are assessed for inclusion in the "post release process".
- Describe clear democratic and meritocratic processes for the appointment of leadership and staff positions in the Application Review Board.
- Remove single points of failure.
For active teams and subprojects with Ubuntu, the Ubuntu Community council delegates many of its responsibilities to "Team Councils." These councils act as proxies for the Community Council over a particular team or scope of activity within the Ubuntu community. These governance councils are ultimately responsible for the actions and activity within their team or scope and resolves disputes and manage policies and procedures internal to their team and frequently appoint Ubuntu members on behalf of the CC.
The Application Review Board (ARB) is the team governance council for assessing post-release applications.
Application Review Board Charter
The ARB is the group that is ultimately responsible for the governing the application review process and how it interfaces with the rest of the Ubuntu community and governance systems. It will:
- Consist of five to seven members. Membership should be public and published.
- Decisions will be made by a majority of voting ARB members when at least three and more than half of the total members have voted.
- ARB members should be accessible by and responsive to the developer community.
- Hold "meetings" regularly and visibly. Meetings can either be in IRC in the "ubuntu-meeting" channel or in a public mailing list.
- Be appointed by the Ubuntu Community Council. Nominations would be open and public and would be considered and evaluated by the CC. Each candidate should prepare a wiki page summarizing their nomination and their contributions and including and referencing testimonials (e.g., something similar to what is prepared for Ubuntu membership). The CC commits to evaluating all nominations on the following criteria, listed in order of importance:
- The nominees active status as an Ubuntu member (essential).
- The nominees support from at least one active Ubuntu developer (essential). - Opinions and testimonials (positive and negative) from current Ubuntu members. - Clear evidence of activity within the developer community (quality, quantity and duration).
- Serve terms of two (2) years. ARB members could serve multiple or repeated terms. Weight will be given to proved contributors and reelection of consistently active members should be both easy and common.
- Have a chairman with a casting vote, appointed by the Community Council.
The ARB would have a number of rights and responsibilities, and be ultimately responsible for approving quality applications for availability to Ubuntu users. These include:
- Evaluating applications, including quality assessments, testing, and code review.
- Resolving disputes in applications as per the existing dispute resolution system.
- Regularly and when possible (i.e., monthly), sending reports or representatives to CC members to weigh in on issues of membership and to update the council on the ARB business.
If this idea is successful, I would think there could be a LOT of submissions. Perhaps some sort of filter mechanism (community voting or automatic sorting by some "quality" metric or some such?) could help the ARB in prioritizing if this turns out to happen.
Some thought should be given to security issues, e.g. if someone uploads an app which contains a trojan or something.
The last thing we need is another board IMO, can we do a separate instance of brainstorm and allow Ubuntu members and developers to vote on submissions. It would be a lot more scalable than having a board to handle everything. --fagan
I think it makes sense to have a board to handle conflict resolution, or to override decisions made against community guidelines (basically, as an arbiter of last resort). However, in line with the rest of Ubuntu, we should have a process that is more community based. I would recommend a submission process that allows an X week voting period, with the ability to circumvent that process by appealing to the ARB. We would also allow user reviews of the product, and enough negative rankings (perhaps categorized into quality, security, usefulness, etc rankings) would take an app out of the repository until the problem is addressed. --ilya haykinson
1. I believe you can improve a bit on submission process. A button implemented in PPA (or project page) can bring all the information required for submission, such as names, emails, project/product description, etc. It will get into maillist automatically. And you may get this without subdomain.
2. I think it should be a community process. If ARB would have to decide for each application, then in time due to the sheer number of the submitted applications
- a) ARB would only have time to work on approving/reviewing applications, and nothing else b) It will take forever for the application to be reviewed/approved
The community can definitely make this process easier. -- Alex Lourie