Relecture d’un article Rzine

Rappel du processus éditorial

Comité éditorial Rzine

Objectifs

Ce document est destiné à l’éditeurice qui va être amené·e à coordonner le cycle de publication. Il résume toutes les étapes du cycle éditorial et rassemble tous les documents utiles à l’interaction entre les différentes parties (auteurices, éditeurices, évaluateurices) impliquées dans ce processus : mail type, consignes générales, choses à faire.

Ce document doit être perçu comme un mémo général. L’éditeurice a la possibilité de l’adapter en fonction de la situation éditoriale qui se présente : évaluateurices connus (tutoiement dans le mail), niveau de connaissance des technologies de versionnement décentralisées par l’ensemble des parties, etc.
Rappel du cycle de soumission

1 Soumission

  • Notification de bonne réception. Mail type.
Bonjour,

Merci beaucoup pour cette initiative. Nous allons faire entrer la fiche dans le 
processus éditorial et revenir vers vous au plus vite pour vous présenter les
étapes à suivre jusqu'à sa publication.

Au plaisir d'échanger,
xx, pour l'équipe RZINE

2 Vérification des critères éditoriaux

  • Respects des critères généraux d’acceptation rassemblés ici
  • Réunion de validation. Règle : Vote à la majorité des membres du comité éditorial.
  • Si validation, identification de personnes en capacité d’évaluer la contribution.
  • Identification d’une personne au sein du comité de lecture qui va coordonner le cycle d’édition (= éditeur) et réaliser la plupart des étapes présentées ci-dessous. Of course, cette personne n’est pas seule et peut bénéficier de l’expérience des membres plus aguerri·e·s de la communauté.

2.1 Validation

  • Fork du dépôt dans rzine-reviews
  • Donner accès aux auteurices au fork du dépôt.
  • Envoi du mail type
Bonjour à toutes et tous, 

Nous avons le plaisir de vous annoncer que la relecture de l'article "xxx" peut 
commencer. 

Comme nous l'expliquons sur le site du projet, l'évaluation des propositions de 
publication Rzine est ouverte et se fait via la production d'issues sur le dépôt 
GitHub de l'article.

Tout au long de ce processus de relecture vous pourrez vous adresser à XXX qui
sera l'éditeurice de cet article. Iel pourra répondre à vos questions sur le 
processus éditorial, ou vous aider avec le markdown, git et GitHub.

Dépôt GitHub de l'article : https://github.com/rzine-reviews/XXX
Article : https://rzine-reviews.github.io/XXX/XXX.html
Issues : https://github.com/rzine-reviews/XXX/issues

La prochaine étape consiste à identifier en accord avec vous des évalateurices
en capacité d'expertiser votre contribution, à la fois sur des aspects thématiques
et méthodologiques. Nous avions pensé à XX 

Avez-vous d'autres expert·e·s que vous souhaitez suggérer ? 

Bien cordialement,

xxx, pour le comité de lecture RZINE.

2.2 Refus

Envoi mail type.

Bonjour à toutes et tous, 

Nous avons le regret de vous annoncer que le comité de lecture a estimé à la 
majorité que votre soumission "xxx" ne suivait pas les consignes éditoriales de la
revue, rappelées dans [ce document](https://rzine-reviews.github.io/documentation/#crit%C3%A8res-dacceptation)

*Si adapté* > Nous vous invitons à réviser votre contribution pour la mettre
en adéquation avec la ligne éditoriale de la collection RZINE.  

Bien cordialement, 

xxx, pour le comité de lecture RZINE.

3 Évaluation

3.1 Contact des évaluateurices potentielles

Envoi mail type si la proposition d’article est validée par le comité éditorial et que des évaluateurices ont été identifié·e·s.

Bonjour, 

Je représente le comité de lecture de la [collection RZINE](https://rzine.fr/collection/#collection).

L'article [xxx](https://rzine-reviews.github.io/XXX/XXX.html) est récemment rentré 
dans le cycle d'édition de la collection. Vous avez été identifié·e comme 
relecteur/trice potentiel.le pour cette contribution.

Les relectures sont publiques et organisées sous forme
d'[issues](https://github.com/rzine-reviews/XXX/issues) dans
le [dépôt]( https://rzine-reviews.github.io/XXX/XXX.html) dédié à
la revue de l'article. <!-- dépôt dédié à l'évaluation de l'article ->

Le délai fixé pour recueillir 2 relectures est habituellement d'un mois. 
Pour toute question technique (issues, github, etc.) nous sommes là pour vous aider. 
<!-- formulation alternative : Si vous rencontrez des problèmes techniques (issues, github, etc.), 
n'hésitez pas à nous contacter -->

Acceptez-vous d'expertiser cette contribution ? 

Bien cordialement,

xxx, pour le comité de lecture RZINE.

3.2 Interaction éditeurice - évaluateurice

  • S’assurer que les évaluateurices ont un compte github. Les aider le cas échéant.
  • Ouvrir les droits (manage access) aux 2 évaluateurices (role: triage).
  • Expliquer le système d’issues pour la review. Si les évaluateurices sont réticent·e·s à l’idée de poster des issues, l’éditeurice récolte les retours des évaluateurices et dépose les issues.

3.3 Rôle de l’éditeurice dans le processus d’évaluation

  • Vérification que le code s’exécute bien, est correctement décrit et correspond aux sorties présentées dans l’article.
  • Présence d’une sessioninfo() en fin d’article.
  • Le lien de téléchargement des données d’exemple est fonctionnel.
  • Les droits d’utilisation des données est explicitement présenté.
  • Présence d’un résumé.

L’éditeurice poste des issues si ce n’est pas le cas.

3.4 Fin du cycle d’évaluation

  • Une fois les retours des évaluateurices-éditeurices déposés dans les issues, rappeler à l’auteurice principal que les modifications doivent idéalement être prises en compte dans un délai raisonnable (1 mois ?)

Une fois les issues prises en compte, deux possibilités :

  • Si les modifications étaient mineures et l’éditeurice estime que les modifications sont prises en compte, passage à l’étape suivante.
  • Si les modifications sont plus importantes, demander la validation des relecteurices.

4 Édition

  • Une ultime passe d’édition est effectuée par Marion Gentilhomme (tips d’orthographe, numérotation des figures, etc.). Ce travail donne lieu à une nouvelle version (commit), à valider par les auteurices (mail à envoyer).

  • En cas de problèmes éditoriaux plus profonds (et qui ne concernent pas le fond de la contribution) une issue peut être envoyée.

  • À ce stade, demander aux auteurices des mots clés pour décrire leur fiche et une thématique d’appartenance

L’éditeurice principal·e, en accord avec au moins un·e directeurice de la collection, valide la publication finale.

5 Publication

Plusieurs étapes sont à suivre :

5.1 Compléter le Readme

L’éditeurice principal·e complète le readMe de la fiche dans le dépôt Github de la manière suivante :

# TITRE [<img src="https://rzine.fr/img/Rzine_logo.png"  align="right" width="120"/>](http://rzine.fr/)
### SOUS-TITRE

**Auteurices :**   
Prénom Nom (Affiliation 1, Affiliation 2)   
Prénom Nom (Affiliation 1, Affiliation 2)   
 
**Évaluateur·trices :**   
Prénom Nom (Affiliation 1, Affiliation 2)   
Prénom Nom (Affiliation 1, Affiliation 2)  

**Résumé :**   
xxxxxxxxxx xxxxxxx xxx xxxxxxxxxx xxxxx xxxxx xxxxxxxxxx xxxxxx xxx

Pour la consulter, cliquez [**ici**](https://rzine-reviews.github.io/xxxxxxxxxxx/)

[![DOI:à venir](https://zenodo.org/badge/DOI/10.48645/xxxx-xxxx.svg)](https://doi.org/10.48645/xxxx-xxxx)
[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg)](http://creativecommons.org/licenses/by-sa/4.0/)

Ensuite, il/elle peut démarrer l’ajout du contenu sur Rzine .fr

5.2 Ajout d’un sous Répertoire dans le site Web (organisation GitLab rzine)

L’éditeurice ajoute dans un sous-répertoire du dossier docs (site web rzine.fr) : - La fiche en format HTML (index.html) et toutes les dépendances ! (dossier figures, data…) - Les données téléchargeables (data.zip) - Le nom du dossier suit le formalisme YYYY_MM_DD_AUTEUR_MOT_CLE_ARTICLE

Pour plus de cohérence, le nom du sous-répertoire doit avoir le même nom dans docs, content/publication_rzine et dans content/publication.

5.3 Création de métadonnées

L’éditeurice principal crée plusieurs pages suivantes sur Rzine .fr (dépôt GitLab).

5.3.1 Modifier (ou créer) les fiches des auteurices

  • Ajouter un nouveau dossier auteur dans content/authors
  • Dans ce dossier, ajouter une image obligatoirement nommée avatar (.png ou .jpeg) plus un fichier markdown style auteur (partir d’un markdown déjà existant).
  • La valeur du paramètre “authors:” (ex authors: hpecout) devra être utilisée dans la landing page de la ressource.
  • Si la fiche est déjà créée : modifier le paramètre user_groups: en indiquant
user_groups:
- Publications Rzine

5.3.2 Initier la Landing page de l’article

Obligatoire pour le dépôt d’un DOI.

  • Ajouter un nouveau dossier dans content/Publication_rzine
  • Dans ce dossier, ajouter - une image d’illustration obligatoirement nommée featured (.png ou .jpeg) - + un fichier bibtex (citation) - + un fichier markdown style Publication_rzine (partir d’un markdown déjà existant). Configuration style fiche rzine : c’est très ressemblant à l’ajout d’une ressource diverse mis à part que les paramètres suivants sont toujours les mêmes :
`publication_types: ["2"]` 
`update: ["0"]`
`projects: [rzine]`
`sources: ["8"]`
`languages : ["0"]`
 `url_source: '/docs/[sous-repertoire]/index.html'`
`url_code: 'https://github.com/rzine-reviews/[sous-repertoire]'`
`url_dataset: '/docs/[sous-repertoire]/data.zip'`
  • Bien utiliser le codename (ex : hpecout) des auteurices (cf. fiche auteur).
  • Ajouter le texte markdown du document, structuré de la manière suivante :
**Auteurices** : [Prénom Nom](https://rzine.fr/authors/codename/), [Prénom Nom](https://rzine.fr/authors/codename/)   
**Evaluateur.rices** : [Prénom Nom](https://rzine.fr/authors/codename/), [Prénom Nom](https://rzine.fr/authors/codename/)   
**Editeur.rices** : Prénom Nom](https://rzine.fr/authors/codename/), [Prénom Nom](https://rzine.fr/authors/codename/)   

#### Résumé 

Incenderat autem audaces usque ad insaniam homines ad haec, quae nefariis egere conatibus, Luscus quidam curator urbis subito visus: eosque ut heiulans baiolorum praecentor ad expediendum quod orsi sunt incitans vocibus crebris. qui haut longe postea ideo vivus exustus est.

#### Citation

<div style="font-size:15px;">
Lambert N (2021). <i>"TITRE"</i>, doi: XXxxXX/XXXXxX, URL: url_de_la_landing_page>.
</div>

<p class="d-inline-flex" style="gap:12px;"><a href="https://doi.org/XXXXxx/XXXXxX"><img style="gap:12px;margin-top:15px;margin-bottom:15px;padding:0;" src="https://zenodo.org/badge/DOI/10.48645/a4ra-yr11.svg" alt="DOI: 10.48645/a4ra-yr11"></a><a href="http://creativecommons.org/licenses/by-sa/4.0/"><img style="gap:12px;margin-top:15px;margin-bottom:15px;padding:0;" src="https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg" alt="License: CC BY-SA 4.0"></a></p>

Il faudra de nouveau modifier cette page pour ajouter le DOI une fois qu’il sera déposé.

5.3.3 Mettre en ligne la landing page

Demander aux administrateurs principaux du site (Hugues, Tim et Seb) de faire un merge pour passer les modifications sur la branche en production (rzine.fr).

À voir si vous voulez documenter un peu plus cette étape Hugues, Tim et Seb pour une transparence parfaite.

5.4 DOI

5.4.1 Déposer le DOI

Rôle habituellement dévolu a Marion Gentilhomme. Le dépôt d’un DOI nécessite les informations suivantes :

À partir de ces informationss, Marion est en mesure de déposer un DOI et une notice sur HAL.

Marion, si tu peux expliquer comment tu fais habituellement pour que ce soit documenté ce serait parfait.

5.4.2 Renseigner le DOI dans l’article

  • Sur la fiche déployée sur GitHub (ex)
  • Sur le ReadME GitHub (ex)
  • Sur la landing page (+ URL sur HAL) et dans le fichier de citation (.bib, ex).

5.5 Mettre en cohérence le dépôt rzine-reviews avec le site web (GitLab)

IMPORTANT : une fois ces modifs réalisées, il faut écraser l’ancienne version de la fiche stockée sur rzine.fr (index.html) dans le sous-répertoire docs

  • Dupliquer le sous-répertoire content/Publication_Rzine/xxxxxx dans content/publication/ pour que la fiche soit également dans la liste des publications diverses

  • L’éditeur.rice demande aux administrateurs principaux du site (hugues, tim et Seb) de faire un merge pour passer toutes les modifications sur la branche en production (rzine.fr)

A voir si vous voulez documenter un peu plus cette étape Hugues, Tim et Seb pour une transparence parfaite.

Et c’est publié ! On peut communiquer !

Infos session

setting value
version R version 4.3.1 (2023-06-16 ucrt)
os Windows 10 x64 (build 19045)
system x86_64, mingw32
ui RTerm
language (EN)
collate French_France.utf8
ctype French_France.utf8
tz Europe/Paris
date 2023-10-19
pandoc 3.1.1 @ C:/Program Files/RStudio/resources/app/bin/quarto/bin/tools/ (via rmarkdown)
package ondiskversion source
knitr 1.44 CRAN (R 4.3.1)
rmarkdown 2.25 CRAN (R 4.3.1)
rzine 0.1.0 gitlab ()

Citation

@Manual{ReviewRzine,
  title = {Processus de relecture d'une fiche},
  author = {{Comité éditorial Rzine}},
  organization = {Rzine},
  year = {2023},
  url = {https://rzine.gitpages.huma-num.fr/help_rzine_reviewing/},
}
COMITÉ ÉDITORIAL RZINE, 2021a. Processus de soumission d’une fiche [en ligne]. S.l. : Rzine. Disponible à l'adresse : https://rzine.gitpages.huma-num.fr/help_rzine_submit/.
COMITÉ ÉDITORIAL RZINE, 2021b. Publier une fiche [en ligne]. S.l. : Rzine. Disponible à l'adresse : https://rzine.gitpages.huma-num.fr/help_rzine_publication/.
COMITÉ ÉDITORIAL RZINE, 2021c. Rédiger une fiche [en ligne]. S.l. : Rzine. Disponible à l'adresse : https://rzine.gitpages.huma-num.fr/Help_Rzine_Layout/.

licensebuttons by-sa/4.0 target="_blank">licensebuttons by-sa/3.0/88x31.png alt="licensebuttons cc">