Improve owner/maintainer documentation (#3313)

* enhancement - in reference to #3157 and #3156

* enhancement - in reference to #3157 and #3156

* enhancement - in reference to #3157 and #3156

* enhancement - in reference to #3157 and #3156

* enhancement - in reference to #3157 and #3156

Author: Jerry Muzsik

warehouse/manage/forms.py

@@ -23,8 +23,8 @@ class RoleNameMixin:
     role_name = wtforms.SelectField(
         'Select a role',
         choices=[
-            ('Owner', 'Owner'),
             ('Maintainer', 'Maintainer'),
+            ('Owner', 'Owner'),
         ],
         validators=[
             wtforms.validators.DataRequired(message="Must select a role"),

warehouse/templates/manage/roles.html

@@ -23,10 +23,10 @@ <h2>Collaborators</h2>
   <div class="callout-block">
     <p>There are two possible roles for collaborators:</p>
     <dl>
-      <dt>Owner</dt>
-      <dd>Owns a package, may add other collaborators for that package, and upload releases for a package.</dd>
       <dt>Maintainer</dt>
-      <dd>May upload releases for a package.</dd>
+      <dd>Can upload releases for a package. Cannot add collaborators. Cannot delete files, releases, or the project.</dd>
+      <dt>Owner</dt>
+      <dd>Can upload releases. Can add other collaborators. Can delete files, releases, or the entire project.</dd>
     </dl>
   </div>
   <table class="table table--light table--collaborators">