Veuillez cliquer ici pour aider. David McMurrey payer pour l'hébergement web :
Faites un don de tout petit montant que vous pouvez !
La rédaction technique en ligne restera gratuite.
Révision par les pairs (également appelé révision par les pairs) signifie que des personnes se réunissent pour lire, commenter et recommander des améliorations sur le travail des autres. La révision par les pairs est un bon moyen de devenir un meilleur écrivain : elle offre une expérience pour examiner de manière critique l'écriture. La révision par les pairs est également un excellent moyen d'améliorer les projets d'écriture.
Écriture en équipe, comme son nom l'indique, signifie que des personnes se réunissent pour planifier, rédiger et réviser des projets d'écriture en groupe ou en équipe. Un autre nom pour cette pratique est l'écriture collaborative—écriture collaborative qui se fait au grand jour plutôt que dans l'ombre (où elle est connue sous le nom de plagiat).
Soyez conscient qu'au cours des dernières années, des applications logicielles pour projets d'équipe ont vu le jour, Atlassian Confluence étant l'une des plus populaires. Il fournit des espaces pour que les membres de l'équipe aient des bureaux, des espaces pour tenir des réunions d'équipe, des mécanismes pour suivre les documents, et plus encore. Un cours en ligne est disponible chez McMurrey Associates : Cours en Communication Technique. Projets de l'équipe de rédaction technique de Confluence
Stratégies pour la révision par les pairs
Lorsque vous évaluez le travail d'un autre écrivain, vous l'évaluez, le critiquez, suggérez des améliorations, puis transmettez tout cela à l'écrivain. En tant que premier évaluateur, vous pourriez être un peu mal à l'aise à l'idée de critiquer le travail de quelqu'un d'autre. Par exemple, comment dire à quelqu'un que son essai est ennuyeux ? Lisez la discussion suivante ; vous y trouverez des conseils et des directives pour effectuer des évaluations par les pairs et communiquer les commentaires d'évaluation par les pairs.
Réunion initiale. Au début d'une révision par les pairs, l'auteur devrait fournir aux évaluateurs des notes sur la tâche d'écriture ainsi que sur les objectifs et les préoccupations concernant le projet d'écriture (sujet, public, but, situation, type), et les alerter sur d'éventuels problèmes ou préoccupations. En tant qu'auteur, vous souhaitez alerter les évaluateurs sur ces problèmes; faites clairement savoir quels types de choses vous essayiez de faire. De même, les évaluateurs devraient demander aux écrivains dont ils examinent le travail de fournir des informations sur leurs objectifs et préoccupations. Les questions de révision par les pairs devraient être spécifiques, comme les suivantes :
Est-ce que mon explication de la machine virtuelle a du sens pour vous ? Est-ce que cela aurait du sens pour nos clients les moins techniques ?
En général, est-ce que mon style d'écriture est trop technique ? (J'ai peut-être trop imité les spécifications des ingénieurs.)
Les titres de chapitres et les sous-titres sont-ils suffisamment indicatifs du contenu suivant ? (J'ai eu du mal à formuler certains d'entre eux.)
Les captures d'écran sont-elles suffisamment claires ? (J'ai peut-être essayé d'inclure trop de détails dans certaines d'entre elles.)
Stratégies de révision par les pairs. Lorsque vous évaluez les écrits des autres, rappelez-vous avant tout que vous devez considérer tous les aspects de cet écrit, pas seulement—en fait, surtout pas—la grammaire, l'orthographe et la ponctuation. Si vous débutez dans l'évaluation par les pairs, vous pouvez oublier de passer en revue le brouillon pour des choses comme les suivantes :
- Assurez-vous que votre avis est complet. Considérez tous les aspects de l'ébauche que vous examinez, pas seulement la grammaire, la ponctuation et l'orthographe.
- Lisez le brouillon plusieurs fois, en cherchant une gamme complète de zones problématiques potentielles :
- Niveau d'intérêt, adaptation au public
- Persuasion, objectif
- Contenu, organisation
- Clarté de la discussion
- Cohérence, utilisez des transitions.
- Titre, introduction et conclusion.
- Style de phrase et clarté
- Gestion des graphiques
- Faites attention à faire des commentaires ou des critiques qui sont basés sur votre propre style personnel. Basez vos critiques et suggestions d'amélioration sur des lignes directrices, concepts et règles généralement acceptés. Si vous faites un commentaire qui est vraiment votre propre préférence, expliquez-le.
- Expliquez pleinement les problèmes que vous trouvez. Ne vous contentez pas de dire qu'un document "semble désorganisé". Expliquez ce qui est désorganisé dans le document. Utilisez des détails spécifiques du brouillon pour démontrer votre point de vue.
- Chaque fois que vous critiquez quelque chose dans le brouillon de l'auteur, essayez de proposer un moyen de corriger le problème. Il ne suffit pas de dire à l'auteur que son document semble désorganisé, par exemple. Expliquez comment ce problème pourrait être résolu.
- Basez vos commentaires et critiques sur des lignes directrices, concepts, principes et règles acceptés. Il ne suffit pas de dire à un écrivain que deux paragraphes devraient être inversés, par exemple. Indiquez la raison : des informations plus générales et introductives devraient venir en premier, par exemple.
- Évitez de réécrire le brouillon que vous examinez. Dans vos efforts pour suggérer des améliorations et des corrections, ne soyez pas excessif et ne réécrivez pas le brouillon vous-même. Cela prive l'auteur de la propriété du document et enlève à l'auteur l'opportunité d'apprendre et de s'améliorer en tant qu'écrivain.
- Trouvez des éléments positifs et encourageants à dire sur le brouillon que vous examinez. Les compliments, même petits, sont généralement très appréciés. Lisez le brouillon au moins une fois en cherchant ce qui a été bien fait, puis faites-le savoir à l'écrivain.
Résumé de l'examen par les pairs. Une fois que vous avez terminé une évaluation par vos pairs, il est judicieux d'écrire un résumé de vos pensées, observations, impressions, critiques ou sentiments concernant le brouillon. Voir la note du relecteur ci-dessous, qui résume les observations sur un brouillon. Remarquez dans la note certains des détails suivants :
- Les commentaires sont classés selon le type de problème ou d'erreur—les commentaires de grammaire et d'utilisation dans un groupe ; des commentaires de niveau supérieur tels que le contenu, l'organisation et le niveau d'intérêt dans un autre groupe.
- L'importance relative des groupes de commentaires est indiquée. Le relecteur indique quelles suggestions seraient "agréables" à incorporer, et lesquelles sont critiques pour le succès du projet d'écriture.
- La plupart des commentaires incluent une brève déclaration de directives, de règles, d'exemples ou de bon sens. Le réviseur ne se contente pas de dire "C'est faux ; corrigez-le." Il explique également le fondement du commentaire.
- Les questions sont adressées à l'écrivain. Le critique vérifie si l'écrivain a vraiment voulu déclarer ou sous-entendre certaines choses.
- Le réviseur inclut des commentaires positifs à faire sur le brouillon, et trouve des moyens non antagonistes et sympathiques d'exprimer les critiques.

Extrait d'une note résumant les résultats d'une évaluation par les pairs. Prenez un moment pour résumer vos commentaires de révision par les pairs dans une note brève à l'auteur. Soyez aussi diplomate et compréhensif que possible !
Stratégies pour l'écriture en équipe
Comme mentionné plus tôt dans ce chapitre, l'écriture en équipe est l'un des moyens courants utilisés par les personnes dans les mondes des affaires, du gouvernement, de la science et de la technologie pour gérer de grands projets d'écriture.

Infographie générée par NotebookLM de ce chapitre
Assembler l'équipe. Lorsque vous commencez à choisir les membres de l'équipe pour un projet d'écriture dans un cours de rédaction technique, choisissez des personnes ayant des parcours et des intérêts différents. Tout comme un parcours diversifié et complet pour un écrivain individuel est un atout, un groupe d'individus diversifiés constitue une équipe d'écriture bien équilibrée.
Si vous êtes le chef d'équipe, vous pourriez même demander aux candidats potentiels leur parcours, leurs intérêts, leurs spécialités, leurs talents et leurs aptitudes. Les équipes d'écriture suivantes regroupent des individus aux parcours et intérêts divers :
| Équipe d'écriture : Les Chaperons Rouges | |
| Projet : | Un rapport sur l'actualité technologies de camouflage |
| Membres de l'équipe | Antécédents, compétences, intérêts |
| Shawn S. | Étudiant en ingénierie électrique, actuellement en train de faire des tâches de gestion de bureau de base dans un cabinet d'avocats. |
| Tracey K. | Étudiant en dernière année d'anglais, espérant que ce cours aide avec les perspectives d'emploi. |
| Sanjiv Gupta | Étudiant en informatique, actuellement en train de faire de la graphique informatique dans une entreprise de développement de logiciels. |
| Jeon Chang Yeon | Bientôt étudiant en génie électrique, développant encore ses compétences en anglais. |
| Alice B. | Majeur non déclaré avec un focus non technique, possibly dans le mauvais cours, aucune compétence déclarée. |
Planification du projet. Une fois que vous avez réuni votre équipe de rédacteurs, la plupart du travail est le même que si vous écriviez seul— sauf que chaque phase est un effort d'équipe. Spécifiquement, rencontrez votre équipe pour décider ou planifier les éléments suivants :
Étapes de planification
|
Capturez les profils et les décisions de votre équipe de manière simple. document de plan d'équipe. Il peut contenir les dates clés du calendrier de l'équipe, un plan provisoire du document à produire en équipe, des accords de formatage, les attributions d'écriture individuelles, les préférences de choix de mots, etc. Une mention est faite ci-dessous d'un document de règlements. Cela peut également être intégré dans le plan de l'équipe.
Une grande partie du travail dans un projet d'écriture en équipe doit être effectuée par les membres individuels de l'équipe de manière autonome. Cependant, si votre équipe décide de diviser le travail pour le projet d'écriture, essayez de respecter au moins ces directives minimales :
- Faites en sorte que chaque membre de l'équipe soit responsable de la rédaction d'une section majeure du document.
- Faites en sorte que chaque membre de l'équipe soit responsable de localiser, lire et prendre des notes sur une part égale des sources d'information.
Une partie du travail pour le projet qui pourrait être réalisée en équipe, vous voudrez peut-être la faire d'abord indépendamment. Par exemple, le brainstorming, le raffinement et surtout la rédaction du plan devraient d'abord être effectués par chaque membre de l'équipe de manière autonome ; ensuite, rassemblez-vous et comparez vos notes. Gardez à l'esprit comment la dynamique de groupe peut involontairement étouffer certaines idées et comment les membres de l'équipe moins assertifs pourraient être réticents à partager leurs idées précieuses dans le contexte de groupe.
Après avoir réparti le travail pour le projet, rédigez un tableau formel et distribuez-le à tous les membres.

Graphique listant les responsabilités des membres de l'équipe de rédaction pour le projet.
Planification du projet et équilibrage de la charge de travail. Dès le début de votre projet d'écriture en équipe, établissez un calendrier des dates clés. Ce calendrier vous permettra, à vous et à vos coéquipiers, de progresser de manière constante et organisée et de terminer le projet à temps. Comme indiqué dans l'exemple de calendrier ci-dessous, incluez non seulement les dates d'achèvement des phases clés du projet, mais aussi les dates de réunion ainsi que le sujet et l'objectif de ces réunions. Notez ces détails concernant ce calendrier :
- Plusieurs réunions sont prévues au cours desquelles les membres discutent des informations qu'ils trouvent ou ne trouvent pas. (Un membre de l'équipe peut avoir des informations qu'un autre membre cherche partout.)
- Plusieurs réunions sont prévues pour examiner les détails du projet, en particulier le sujet, le public, l'objectif, la situation et le plan. Au fur et à mesure que vous en apprendrez davantage sur le sujet et que vous vous sentirez plus à l'aise avec le projet, votre équipe pourrait vouloir modifier certains de ces détails ou les rendre plus spécifiques.
- Plusieurs ébauches sont prévues. Les membres de l'équipe relisent les ébauches des sections individuelles des autres au moins deux fois, la deuxième fois pour voir si les changements recommandés ont fonctionné. Une fois le brouillon complet assemblé, il est aussi révisé deux fois.

Calendrier pour un projet d'écriture en équipe
Anticiper les problèmes et créer des règlements pour l'équipe. Réfléchissez à la façon de résoudre les problèmes typiques qui peuvent survenir dans un projet d'équipe et documentez les accords de votre équipe à ce sujet dans un document de règlements internes:
- Déséquilibre de charge de travail. Lorsque vous travaillez en équipe, il y a toujours un risque qu'un des membres de l'équipe, pour une raison quelconque, ait plus ou moins qu'une juste part de la charge de travail. Il est donc important de trouver un moyen de suivre ce que fait chaque membre de l'équipe. Un bon moyen de le faire est de demander aux membres individuels de l'équipe de tenir un journal ou un registre du type de travail qu'ils effectuent et du temps qu'ils y consacrent.
À la fois pendant et à la fin du projet, s'il y a des problèmes, le journal devrait rendre ce fait très clair et permettre un équilibre plus équitable de la charge de travail. À la fin du projet, les membres de l'équipe peuvent additionner leurs heures passées sur le projet ; si quelqu'un a passé un peu plus que sa part de temps à travailler, les autres membres peuvent compenser cela en lui achetant le dîner ou une récompense similaire. De même, à mesure que vous vous approchez de la fin du projet, s'il est évident d'après les journaux qu'un membre de l'équipe a eu des responsabilités de travail qui se sont avérées, sans faute de sa part, plus petites que celles des autres, il peut compenser en effectuant davantage de travail de finition tel que taper, corriger ou copier. - Membres de l'équipe sans compétences pertinentes. Comme vous pouvez le voir dans la description d'exemple des compétences des membres de l'équipe ci-dessus, un membre n'a pas de compétences pertinentes avec lesquelles contribuer au projet. Parfois, c'est juste une indication de l'anxiété de cette personne ou d'un manque d'intérêt à s'engager dans un projet de groupe. Bien sûr, chaque membre de l'équipe dans un cours d'écriture devrait contribuer une part équitable de l'écriture pour un projet. Cependant, il existe de nombreuses tâches qui ne nécessitent pas de connaissances techniques, de compétences en formatage ou d'un œil éditorial aiguisé, par exemple : rédiger et distribuer le plan de l'équipe, les règlements internes, les procès-verbaux des réunions d'équipe ; rappeler aux membres de l'équipe les dates limites et les réunions programmées. En fait, sauf pour l'anxiété ou le manque d'intérêt, le membre de l'équipe qui se considère comme non qualifié pourrait faire le meilleur leader d'équipe !
- Membres de l'équipe qui disparaissent. Si votre équipe a la malchance d'avoir un membre irresponsable qui disparaît simplement, ayez un plan pour faire face à cela, et documentez-le dans les règlements de votre équipe. Une solution évidente est d'exclure le membre de l'équipe et d'informer l'instructeur si c'est un cours d'écriture ou le niveau de gestion supérieur si c'est une organisation non académique.
- Désaccords apparemment enracinés entre les membres de l'équipe. Il est incroyable de voir à quel point les membres de l'équipe peuvent être en désaccord sur des aspects d'un projet d'écriture en équipe. Ayez un plan, écrit dans vos règlements d'équipe, pour résoudre ces questions. Devront-elles être soumises à un vote ? Devriez-vous "escalader" la question à une partie neutre ou de niveau supérieur ?
- Styles d'écriture et format radicalement inconsistants. Parce que les sections individuelles seront écrites par différents écrivains qui ont tendance à avoir des styles d'écriture différents, élaborez un guide de style dans lequel vos membres d'équipe énoncent leurs accords sur la façon dont les choses doivent être traitées dans le document dans son ensemble. Ces accords peuvent aller du niveau élevé, comme la décision d'inclure une section de contexte, jusqu'aux détails précis tels que le choix entre l'utilisation d'italiques ou de gras et s'il faut dire "cliquer" ou "cliquer sur". Voir l'extrait d'une feuille de style de projet ci-dessous. Pour la discussion de ces éléments, voir feuilles de style et guides de style.
Avant que vous et les membres de votre équipe n'écriviez les premiers brouillons, vous ne pouvez pas vous attendre à anticiper chaque différence possible de style et de format. Par conséquent, prévoyez de mettre à jour cette feuille de style lorsque vous examinerez les brouillons des sections individuelles et, surtout, lorsque vous examinerez le brouillon complet.

Extrait d'un guide de style pour un projet d'écriture. Les éléments énumérés représentent les accords que les rédacteurs de l'équipe ont pris pour donner à leur document autant de cohérence que possible.
Révision des brouillons et finition. Essayez de programmer autant de revues que possible des travaux écrits de votre équipe. Vous pouvez vous rencontrer pour discuter des brouillons de chaque section ainsi que des brouillons complets du document. Lorsque vous vous rencontrez, suivez les suggestions de révision par les pairs abordées dans la section précédente de ce chapitre. Stratégies pour l'examen par les pairs.
Une étape critique dans l'écriture collaborative d'un document se présente lorsque vous réunissez en un seul brouillon complet les sections individuelles rédigées par différents membres de l'équipe. C'est alors que vous verrez probablement à quel point le ton, le traitement et le style de chaque section sont différents. Vous devez, en groupe, trouver un moyen de réviser et d'éditer le brouillon complet afin qu'il soit cohérent et qu'il ne donne pas l'impression d'avoir été écrit par trois ou quatre personnes différentes.
Quand vous avez fini de revoir et de réviser, il est temps de faire les finitions pour préparer le brouillon à remettre. Ce travail est le même que si vous écriviez le document seul, sauf que dans ce cas, les charges de travail peuvent être réparties.
Informations connexes
Coût réel de la révision de la documentation dans Word. clickhelp.com
J'apprécierais vos pensées, réactions, critiques concernant ce chapitre : votre réponse—David McMurrey.
