Komentarze i zadania

Recenzuj stronę tam, gdzie ona jest. Komentarz kotwiczy się w bloku, oznaczenie dociera do człowieka, a uwaga do zrobienia staje się zadaniem z właścicielem.

Recenzja zwykle dzieje się gdzie indziej - w wątku na czacie, w dokumencie, w arkuszu z uwagami - a potem ktoś musi przenieść każdą uwagę z powrotem do rzeczy, której dotyczyła. Komentarze i zadania żyją na stronie i potrafią wskazać pojedynczy blok, więc nikt nie musi opisywać słowami, o który fragment chodzi.

Komentarze

Komentarz należy do strony, a opcjonalnie do jednego bloku w niej. Zakotwiczony w bloku pokazuje się jako pinezka na kanwie; zakotwiczony w stronie siedzi w panelu bez pinezki. Odpowiedzi tworzą wątek pod komentarzem, na który odpowiadają.

Co niesie komentarz:

  • Do 5000 znaków treści.
  • Oznaczenia członków workspace'u - to one zamieniają uwagę w czyjąś sprawę, a nie notatkę, której nikt nie czyta.
  • Status otwarty albo rozwiązany. Rozwiązanie zapisuje, kto i kiedy - więc pytanie „czy to załatwione?" ma odpowiedź inną niż czyjaś pamięć.

Kto dostaje sygnał

Oznaczenie kogoś wysyła mu powiadomienie w aplikacji i e-mail z nazwą strony i fragmentem tego, co napisałeś. Kliknięcie powiadomienia otwiera stronę przy tym komentarzu, a nie na górze.

Odpowiedź powiadamia też autora komentarza, na który odpowiadasz - chyba że sam nim jesteś albo już go w tej odpowiedzi oznaczyłeś. Dwa sygnały za jedną wiadomość to sposób, w jaki ludzie uczą się ignorować powiadomienia, więc ich nie wysyła.

Zadania

Komentarz mówi, co jest nie tak. Zadanie mówi, kto to naprawi i do kiedy. Zadania kotwiczą się tak samo - w stronie, opcjonalnie w bloku - i niosą:

  • Tytuł do 200 znaków i opcjonalny opis do 5000.
  • Osobę przypisaną, która dostaje powiadomienie, gdy zadanie na nią spada.
  • Status: do zrobienia, w toku albo zrobione. Zmiana statusu też powiadamia zainteresowanych.
  • Opcjonalny termin.

Wszystkie zadania przypisane Tobie w całym workspace są dostępne w jednej liście - żeby osoba redagująca dziesięć stron nie musiała otwierać dziesięciu stron, żeby się dowiedzieć, co na nią czeka.

Uprawnienia

Czytanie komentarzy i zadań wymaga pages:view na tej stronie, nie na workspace w ogóle - rola zawężona do części stron nie przeczyta dyskusji na reszcie. Pisanie, rozwiązywanie, przypisywanie i usuwanie wymaga pages:edit.

To ma znaczenie, gdy zapraszasz recenzenta. Recenzent, który może tylko oglądać strony, przeczyta wątek, ale na niego nie odpowie. Jeśli chcesz jego opinię na piśmie, potrzebuje prawa edycji na stronach, które ma zrecenzować.

Dokąd to nie sięga

Komentarze i zadania to powierzchnia redakcyjna: aplikacja admina i API GraphQL. Nie ma ich w API dostarczania, więc nic stąd nigdy nie trafia do czytelników Twojego serwisu, i nie są wystawione jako narzędzia MCP - agent może napisać Twoją treść, ale nie zostawi Ci o niej komentarza.

Następne kroki