This is the outline of a specification for how [[http://developer.ubuntu.com/|the Ubuntu developer site]] should accept and present application submissions from developers, and show usage and ranking for published applications.

<<TableOfContents()>>

== General ==

<<Anchor(developer-registers)>>
=== Developer registers an account ===

{{attachment:publishing-account.png}}

The “Company name:” field should be sensitive whenever “I submit apps on behalf of a company” is checked.

The “Different Paypal address:” field should be sensitive whenever its checkbox is checked.

As much as practical, the address fields should match the selected country. For example, if “United States” is selected, there should be a “Zip:” field.

Until it has manually been changed for the first time, the “Phone number:” field should be pre-filled with “+” and the country code for the selected country.

=== Developer signs in ===

== Publishing applications ==

=== Developer finds out how to submit an application ===

=== Developer submits an application ===

==== Basics ====

{{attachment:publishing-basics-clash.png}}

==== Classification ====

{{attachment:publishing-classification.png}}

==== Hardware requirements ====

{{attachment:publishing-hardware-requirements.png}}

==== Artwork ====

=== Developer receives immediate feedback ===

{{attachment:publishing-finished-errors.png}}

=== Developer withdraws an submission ===

=== Developer sees whether application has been accepted ===

=== Developer changes metadata for an application ===

=== Developer submits an update to an application ===

…nicely formatted description of what’s new…

==== Developer withdraws an update submission ====

=== Reviewer sees submitted applications ===

<<Anchor(reviewer-edits)>>
=== Reviewer tweaks application details ===

So that they can fix typos and other small errors, reviewers should have the same “Edit” links, to the same forms for editing details, as an application developer does (bug Bug:797093).

<<Anchor(reviewing)>>
=== Reviewer reviews an application ===

When you are signed in as a reviewer, the application screen should have a “Review” link that opens a “Reviewing” page in a separate tab/window.

{{attachment:publishing-reviewing.png}}

 * When “Ask the submitter for more information” is selected, the comment field should be “Your message to the '''submitter''' ({name of submitter}):”.

 * When “Reject the application” or “Approve for publication” are selected, the comment field should be “Your message to the '''submitter''' ({name of submitter}) (optional):”.

 * When “Return to the packager for corrections” is selected, the comment field should be “Your message to the '''packager''':” (bug Bug:857414).

== Status ==

=== Developer sees status of their current applications ===

 * total downloads
  * overall ranking
  * ranking within department
  * ranking by country

 * median rating
  * overall ranking
  * ranking within department
  * ranking by country
 * individual ratings and reviews