Fonctionnement actuel de SPIP

SPIP propose en standard un système permettant de commenter un article dans l’espace privé. Ce système utilise, d’une part, le statut des articles (en rédaction, proposé à l’évaluation, publié), et d’autre part, les messages de forum internes attachés à l’article si la configuration l’autorise.

Cependant, ce système de commentaires n’est pas un véritable « workflow » car, d’une part, les transitions entre statut d’article ne suivent aucune logique prédéfinie, et d’autre part, les commentaires ne peuvent pas être liés à une partie du texte de l’article sauf à l’y insérer en citation dans le message.

En outre, il n’est pas possible d’indiquer une période de relecture donnée ni de fournir un rapport de relecture imprimable ou consultable a posteriori.

Objectifs du plugin Relecture

L’idée du plugin est de fournir un outil de gestion de cycle de relecture sur les articles avant leur publication, en proposant :

• un mini workflow de gestion du cycle de relecture - article en relecture, article relu et pouvant être publié - le statut de l’article étant gelé pendant la relecture. L’auteur peut choisir la période de relecture ainsi que la liste des relecteurs parmi les auteurs du site.
• une interface d’insertion de commentaire en un point précis du texte de l’article. Le texte du commentaire est affiché en regard du point d’insertion et repère son auteur par son nom et sa date de création.
• une interface de suivi de la relecture listant l’ensemble des commentaires, leurs auteurs et assurant la gestion de la prise en compte des commentaires par l’auteur de l’article.

La relecture reste accessible - en lecture uniquement - après que le cycle ait été clôturé. Plusieurs relectures peuvent être attribuables à un article même si ce n’est pas un cas fréquent.

Il n’est pas prévu, contrairement à la gestion des révisions disponible dans les traitements de texte, d’associer la relecture et les révisions de l’article. Cependant, pour permettre à l’auteur de corriger l’article pendant la période de relecture en prenant en compte les commentaires, le plugin Relecture utilise uniquement la révision de l’article au moment de l’ouverture du cycle de relecture.

Gestion du workflow

Un cycle de relecture ne peut être ouvert que si le statut de l’article est « proposé à l’évaluation ». Pour un article donné, il est défini par :

• une période de relecture pendant laquelle les commentaires sont autorisés. Si celle-ci n’est pas précisée, l’édition de commentaires se termine avec la clôture formelle du cycle.
• une liste de relecteurs. Si celle-ci n’est pas précisée, tous les rédacteurs du site sont considérés comme des relecteurs potentiels.
• une description qui permet à l’auteur de l’article de préciser les attendus de la relecture, si besoin.

Le diagramme d’état-transition du workflow induit par l’ouverture d’un cycle de relecture est le suivant :

Durant la période de relecture, le statut de l’article est gelé à « en relecture ». Par contre, les modifications de l’article sont possibles en particulier pour prendre en compte les corrections proposées.

La clôture d’un cycle de relecture ne peut être prononcée que si l’ensemble des commentaires a été fermé : concernant les modifications de l’article, il est supposé que celles-ci sont faites concomitamment avec la fermeture des commentaires mais aucune vérification n’est faite à cet égard par le plugin.
Seul l’auteur de l’article ou un admin peut prononcer la clôture de la relecture.

Une option pourrait être de publier automatiquement l’article suite à la clôture de la relecture.

Édition des commentaires

L’ajout, la modification et la suppression des commentaires n’est pas incluse dans la page d’édition de l’article afin de ne pas en surcharger l’affichage. Seul un bloc de synthèse sur la relecture y est inséré.

La fonction d’édition est basée sur les principes suivants :

• le texte de l’article - chapeau, descriptif, texte et post-scriptum est affiché dans des blocs distincts successifs à l’instar de la page d’édition de l’article.
• le relecteur désigne un endroit précis du texte et y insère un commentaire par l’intermédiaire d’un formulaire de saisie de texte. Le commentaire s’affiche dans une boite en regard du texte de l’article tandis qu’un repère indique dans le texte de l’article le numéro de ce commentaire.
• Les repères sont cliquables et permettent de mettre en avant le commentaire associé.
• L’auteur d’un commentaire peut le modifier voire le supprimer tant que celui-ci n’est pas fermé - accepté ou refusé - ou ouvert mais discuté (existence de messages de forums).

L’édition devient impossible quand la période de relecture a échu.

Suivi du cycle de relecture

L’auteur de l’article peut consulter l’état du cycle de relecture et décider à tout moment :

• de proroger la fin de la période de relecture
• de clôturer la relecture à partir du moment où tous les commentaires ont été fermés,
• d’afficher la liste des commentaires déjà ajoutés par les relecteurs et la filtrer/trier par relecteurs, par date...
• de fermer des commentaires en positionnant leur état de prise en compte : accepté ou refusé. Un refus doit toujours être justifié par une explication.

Un système de notifications permet aux administrateurs de la relecture et aux relecteurs d’en suivre le déroulement.

Les relecteurs et les auteurs de l’article peuvent aussi avoir accès après la clôture, en lecture, à ce suivi appelé « fiche de relecture ». La fiche de relecture peut être exportée ou imprimée si besoin.

Acteurs de la relecture

Il existe deux catégories d’acteurs pour une relecture :

• ceux qui sont autorisés à ouvrir et administrer un cycle de relecture (y compris la prise en compte des commentaires) ;
• ceux qui sont autorisés à participer à la relecture en déposant des commentaires — les relecteurs — ou en les discutant.

Pour être cohérent avec les autorisations liés aux articles, les acteurs de la première catégorie sont les auteurs de l’article ainsi que les administrateurs complets ou restreints à la rubrique d’appartenance de l’article.

La deuxième catégorie regroupent elle, les relecteurs désignés (ou tous les rédacteurs suivant la configuration de la relecture) ainsi que les acteurs de la première catégorie.