Commentaires et tâches
Relisez une page là où elle est. Un commentaire s'ancre à un bloc, une mention atteint quelqu'un, et une remarque à traiter devient une tâche avec un responsable.
La relecture se passe d'ordinaire ailleurs - un fil de discussion, un document, une liste de remarques - et ensuite quelqu'un doit rapporter chaque remarque à ce qu'elle visait. Les commentaires et les tâches vivent sur la page, et peuvent désigner un bloc précis : personne n'a à décrire avec des mots de quel passage il s'agissait.
Commentaires
Un commentaire appartient à une page, et facultativement à un seul bloc à l'intérieur. Ancré à un bloc, il apparaît comme une épingle sur le canevas ; ancré à la page, il reste dans le panneau sans épingle. Les réponses forment un fil sous le commentaire auquel elles répondent.
Ce que porte un commentaire :
- Jusqu'à 5000 caractères.
- Des mentions de membres de l'espace de travail - c'est ce qui transforme une remarque en affaire de quelqu'un plutôt qu'en note que personne ne lit.
- Un statut : ouvert ou résolu. La résolution enregistre qui et quand, si bien que « est-ce que ça a été traité ? » a une réponse qui n'est pas la mémoire de quelqu'un.
Qui est prévenu
Mentionner quelqu'un lui envoie une notification dans l'application et un e-mail portant le nom de la page et un extrait de ce que vous avez écrit. Cliquer dessus ouvre la page à ce commentaire, et non en haut.
Une réponse prévient aussi l'auteur du commentaire auquel vous répondez - sauf si c'est vous, ou si vous l'avez déjà mentionné dans la réponse. Deux signaux pour un message, c'est ainsi qu'on apprend à ignorer les notifications.
Tâches
Un commentaire dit ce qui ne va pas. Une tâche dit qui le corrige et pour quand. Les tâches s'ancrent de la même façon - à une page, facultativement à un bloc - et portent :
- Un titre jusqu'à 200 caractères, et une description facultative jusqu'à 5000.
- Un responsable, prévenu quand la tâche lui échoit.
- Un statut : à faire, en cours ou terminé. Le changer prévient les intéressés.
- Une échéance facultative.
Toutes les tâches qui vous sont assignées dans l'espace de travail tiennent dans une seule liste - pour qu'une personne qui suit dix pages n'ait pas à ouvrir dix pages pour savoir ce qui l'attend.
Permissions
Lire les commentaires et les tâches demande pages:view sur cette page, pas sur l'espace de travail en général : un rôle limité à certaines pages ne lit pas la discussion sur les autres. Écrire, résoudre, assigner et supprimer demandent pages:edit.
Cela compte quand vous invitez un relecteur. Qui ne peut que consulter les pages lira le fil sans pouvoir y répondre. Si vous voulez son avis par écrit, il lui faut le droit d'édition sur les pages concernées.
Où cela ne va pas
Les commentaires et les tâches sont une surface éditoriale : l'application d'administration et l'API GraphQL. Ils ne font pas partie de l'API de livraison, rien de tout cela n'atteint donc les lecteurs de votre site, et ils ne sont pas exposés comme outils MCP - un agent peut écrire votre contenu, mais pas vous laisser un commentaire à son sujet.
Étapes suivantes
- Constructeur de pages - le canevas où se posent les épingles.
- Membres et rôles - ce que
pages:viewetpages:editsignifient dans un rôle.