role: document maintainer role and split maintainer list and tracker_admin

The split allow to only list maintainer in the team static page.

Author: Trim

app/controllers/trackers_controller.rb

@@ -88,7 +88,7 @@ def destroy
 protected
 
   def tracker_params
-    if current_account.try(:admin?) or current_account.try(:maintainer?)
+    if current_account.try(:tracker_admin?)
       params.require(:tracker).permit!
     else
       params.require(:tracker).permit(:title, :wiki_body, :category_id, :state)

app/helpers/static_helper.rb

@@ -26,6 +26,10 @@ def helper_moderator_list
     people_list Account.moderator
   end
 
+  def helper_maintainer_list
+    people_list Account.maintainer
+  end
+
   def helper_friend_sites_list
     sites = FriendSite.all.map { |s| content_tag(:li, link_to(s.title, s.url)) }
     content_tag(:ul, safe_join(sites), class: "people-list")

app/models/account.rb

@@ -128,7 +128,8 @@ def update_with_password(params={}, *options)
 ### Role ###
 
   scope :active,    -> { where("role != 'inactive'") }
-  scope :maintainer, -> { where(role: %w[admin maintainer]) }
+  scope :maintainer, -> { where(role: "maintainer") }
+  scope :tracker_admin, -> { where(role: %w[admin maintainer]) }
   scope :moderator, -> { where(role: "moderator") }
   scope :editor,    -> { where(role: "editor") }
   scope :admin,     -> { where(role: "admin") }
@@ -162,6 +163,11 @@ def log_role
     logs.create(description: "Changement de rôle : #{roles.join ' → '}", user_id: amr_id)
   end
 
+  # A tracker admin can update, assign and delete a node of the tracker
+  def tracker_admin?
+    admin? || maintainer?
+  end
+
   # An AMR is someone who is either an admin or a moderator
   def amr?
     admin? || moderator?

app/views/trackers/_form.html.haml

@@ -17,10 +17,10 @@
   %p
     = form.label :state, "État"
     = form.select :state, Tracker::States.invert
-  - if current_account.admin? or current_account.maintainer?
+  - if current_account.tracker_admin?
     %p
       = form.label :assigned_to_user_id, "Assigné à"
-      = form.collection_select :assigned_to_user_id, Account.maintainer, :user_id, :login, include_blank: true
+      = form.collection_select :assigned_to_user_id, Account.tracker_admin, :user_id, :login, include_blank: true
 %p
   = form.submit "Prévisualiser", id: "tracker_preview"
   = form.submit "Soumettre", 'data-disable-with' => "Enregistrement en cours" if @preview_mode || @tracker.persisted?

app/views/trackers/index.html.haml

@@ -22,7 +22,7 @@
     = f.collection_select :category_id, Category.all, :id, :title, include_blank: true
   %p
     = f.label :assigned_to_user_id, "Assigné à : "
-    = f.collection_select :assigned_to_user_id, Account.maintainer, :user_id, :name, include_blank: true
+    = f.collection_select :assigned_to_user_id, Account.tracker_admin, :user_id, :name, include_blank: true
   %p
     = label_tag :order, "Trier par : "
     = select_tag :order, options_for_select({ "Date d’ouverture" => "created_at", "Note" => "score", "Nombre de commentaires" => "comments_count", "Dernier commentaire" => "last_commented_at" }, @order)

db/pages/aide.html

@@ -114,6 +114,11 @@ <h2 id="aide-authentification">Visiteur (non) authentifié, ou pourquoi ouvrir u
 
 <p>Le modérateur est par ailleurs abonné à la liste de discussion <a href="https://lists.linuxfr.org/wws/arc/meta"><em>meta@</em></a> de coordination des équipes du site ainsi qu’à la liste de discussion <a href="https://lists.linuxfr.org/wws/arc/moderateurs"><em>moderateurs@</em></a>.</p>
 
+<p>Par rapport à un visiteur, un mainteneur (rôle <i>mainteneur</i>) peut :</p>
+<ul>
+<li>gérer les bogues et propositions d’évolution signalés dans le <a href="//linuxfr.org/suivi">système de suivi</a> (édition, assignation à un mainteneur et suppression) ;</li>
+</ul>
+
 <p>Un admin (rôle <i>admin</i>) cumule toutes les possibilités précédentes, et peut en plus :</p>
 <ul>
 <li>créditer le karma d’un compte de 50 points ;</li>
@@ -310,6 +315,7 @@ <h2 id="aide-role">À quoi correspond le rôle sur la page d’un utilisateur
 <li>compte fermé (<i>inactive</i>) : les comptes fermés ;</li>
 <li>modérateur (<i>moderator</i>) : les <a href="/team">modérateurs</a> ;</li>
 <li>animateur (<i>editor</i>) : les <a href="/team">animateurs de l’espace de rédaction</a> ;</li>
+<li>mainteneur (<i>maintainer</i>) : les <a href="/team">mainteneurs du site</a> ;</li>
 <li>visiteur ou contributeur (<i>visitor</i>) : les visiteurs, tous ceux qui ne sont pas dans une catégorie précédente, suivant s’ils ont déjà écrits des contenus ou non.</li>
 </ul>
 

db/pages/team.html

@@ -25,6 +25,16 @@ <h2>Les animateurs de l’espace de rédaction</h2>
 </p>
 {{editor_list}}
 
+<h2>Les mainteneurs du site</h2>
+<p>
+Ils s'occupent de maintenir et faire évoluer le code du site <em>LinuxFr.org</em>.
+Ils gèrent les bogues et propositions d'évolution signalés dans le 
+<a href="//linuxfr.org/suivi">système de suivi</a> (édition, assignation à un mainteneur et suppression).
+<p>
+  Les mainteneuses et mainteneurs actuels sont:
+</p>
+{{maintainer_list}}
+
 <h2>Les administrateurs</h2>
 <p>
 Les serveurs de <em>LinuxFr.org</em> sont administrés par une équipe très compétente (si si, je vous assure).