# Commentaires

Commenter du texte dans un projet partagé, mentionner des personnes, répondre, résoudre et rouvrir des discussions, et ce qui se passe quand les commentaires sont désactivés.

Les commentaires vous permettent de discuter du texte sans le modifier. Ils vivent avec le projet partagé, donc tous les participants voient les mêmes discussions. Ils ne vont jamais dans vos fichiers ni dans votre PDF.

Les propriétaires, éditeurs, relecteurs et commentateurs peuvent commenter. Pour un commentateur, l'éditeur est en lecture seule, mais il peut quand même sélectionner du texte et le commenter. Les lecteurs peuvent lire les commentaires mais pas en écrire.

## Ajouter un commentaire

1. Sélectionnez le texte que vous voulez commenter.
2. Choisissez **Ajouter un commentaire** dans le menu qui apparaît au-dessus de la sélection, ou dans le menu contextuel.
3. Le panneau **Commentaires** s'ouvre avec le texte sélectionné cité en haut. Écrivez votre commentaire puis choisissez **Commenter**.

Les lignes qui portent des commentaires reçoivent un marqueur à côté d'elles dans l'éditeur. Sélectionnez le marqueur pour afficher ces commentaires.

Un commentaire reste attaché à son texte pendant que les gens éditent autour. Si quelqu'un ajoute des mots dans le texte commenté, le commentaire s'étend pour les couvrir.

Vous pouvez commenter hors ligne. Vos commentaires partent avec vos autres modifications quand vous vous reconnectez.

## Mentionner quelqu'un

Tapez `@` dans un commentaire ou une réponse puis choisissez une personne dans la liste. Elle reçoit une entrée dans **Activité** disant que vous l'avez mentionnée, avec **Voir le commentaire** pour y sauter.

Si le serveur envoie des courriels, la personne que vous mentionnez reçoit aussi un courriel une minute environ plus tard. Il indique qui l'a mentionnée, le projet et le fichier, le texte sur lequel porte le commentaire et le commentaire lui-même, avec un lien qui ouvre le commentaire dans Oleafly. Les mentions qui arrivent dans cette minute sont regroupées dans un seul courriel.

Personne ne reçoit de courriel pour ses propres commentaires, ni pour un projet qu'elle ne peut pas ouvrir. Modifier un commentaire n'envoie jamais deux fois la même mention. Pour arrêter les courriels de mention, ouvrez **Paramètres → Collaboration**, trouvez la carte du serveur et désactivez **M'envoyer un courriel quand quelqu'un me mentionne dans un commentaire**.

## Répondre, résoudre et rouvrir

- **Répondre** ajoute à la discussion.
- **Résoudre** marque la discussion comme terminée et masque la discussion. La discussion indique qui l'a résolue.
- **Afficher les commentaires résolus**, en haut du panneau, remet les discussions résolues en vue. Choisissez **Rouvrir** sur l'une pour la rendre active de nouveau.

Si deux personnes résolvent ou répondent au même moment, tout le monde se retrouve avec la même discussion.

## Modifier ou supprimer

Vous ne pouvez modifier que ce que vous avez écrit vous-même. Ouvrez le menu d'actions sur votre commentaire pour le modifier ou le supprimer. Un commentaire modifié porte la marque **Modifié**. Un commentaire supprimé laisse la note « Ce commentaire a été supprimé. » pour que les réponses gardent leur sens.

Pour supprimer une discussion entière que vous avez commencée, choisissez **Supprimer la discussion** dans le menu d'actions de la discussion. Si quelqu'un d'autre a déjà répondu, la discussion reste. Résolvez-la plutôt.

## Le panneau des commentaires

Le panneau **Commentaires** s'ouvre depuis le rail du projet. Il montre les commentaires de tout le projet, regroupés par fichier, avec le fichier ouvert en premier. Un fichier sans commentaires n'a pas de section. Quand le projet n'a aucun commentaire, le panneau le dit en une ligne.

Choisissez **Afficher dans l'éditeur** sur une discussion pour aller au texte sur lequel elle porte.

Les modifications suggérées apparaissent aussi dans ce panneau, dans les mêmes sections par fichier, chacune avec sa propre zone **Réponse**. Lisez [Suggérer des modifications](/docs/collaboration/suggesting/#review-suggestions).

### Les commentaires qui ont perdu leur texte

Quand tout le texte sur lequel portait un commentaire est supprimé, la discussion passe dans une section **Détachés** avec la note « Le texte de ces commentaires a été supprimé. » Vous pouvez encore y lire la discussion.

### Les commentaires qu'Oleafly n'a pas pu vérifier

Oleafly vérifie qui a écrit chaque commentaire. S'il ne peut pas confirmer l'auteur, il marque le commentaire « Impossible de vérifier qui a écrit ceci ».

## Désactiver les commentaires

Le propriétaire du projet peut désactiver les commentaires dans le dialogue **Partager** avec l'interrupteur **Commentaires**. Un administrateur du serveur peut les désactiver pour tous les projets du serveur avec **Autoriser les commentaires**. Dans les deux cas, les commentaires sont masqués mais pas supprimés. Les réactiver ramène chaque discussion, et tous les participants au projet voient le changement immédiatement.

Pendant que les commentaires sont désactivés, personne ne peut en ajouter ni en modifier, et le panneau indique pourquoi.

### Les commentaires écrits pendant que les commentaires étaient désactivés

Parfois, une personne écrit un commentaire hors ligne, et le propriétaire désactive les commentaires avant qu'il n'atteigne le serveur. Quand cette personne se reconnecte :

- Les commentaires ne sont pas envoyés. Un avis dit « Les commentaires sont désactivés pour ce projet, donc les commentaires que vous avez écrits n'ont pas été envoyés. »
- **Afficher ce que vous avez écrit** liste le texte de ces commentaires, et **Copier le texte** le copie pour que vous puissiez le garder ailleurs.
- Tout le reste que la personne a écrit est envoyé comme d'habitude. Seuls les commentaires sont retenus.
