Recenzje i pytania

Pod każdym opublikowanym modułem na modules.orbito.pl są dwie zakładki tworzone przez użytkowników: Recenzje (ocena i opinia) i Pytania (pytania do autora z odpowiedziami). Szersze rozmowy — pomoc, pomysły, wdrożenia — toczą się na forum.

Wszystko czyta się bez logowania. Pisze każdy, kto ma konto Orbito: przycisk „Zaloguj się” w sklepie otwiera logowanie tym samym e-mailem i hasłem co panel my.orbi.do. Treści (recenzje, pytania, odpowiedzi, posty) piszesz w markdownie, bez HTML-a i bez wgrywania obrazków.

Recenzje

Kto może ocenić

• Każdy zalogowany użytkownik Orbito. Repozytorium nie sprawdza, czy Twoja firma ma moduł zainstalowany.
• Jedna recenzja na moduł. Kolejny zapis zastępuje poprzednią recenzję, a nie dodaje nowej.
• Autor nie ocenia własnych modułów — członek namespace'u modułu dostaje odmowę.
• Ocenić można tylko moduł opublikowany. Moduły robocze (drafty) nie mają strony w sklepie.

Gdzie

Na karcie modułu w sklepie: https://modules.orbito.pl/modules/<namespace>/<slug>?tab=reviews. Najprościej z panelu Orbito — w szczegółach modułu w sklepie panelu (Ustawienia → Moduły) link „Oceń na modules.orbito.pl” otwiera właśnie tę zakładkę. Panel recenzji nie przyjmuje; pokazuje tylko link.

Co zawiera recenzja

Przy recenzji widać nazwę Twojego konta Orbito i awatar z profilu — nigdy e-mail. Własną recenzję możesz w każdej chwili poprawić albo usunąć.

Karta modułu pokazuje średnią (z dokładnością do 0,1), liczbę recenzji i rozkład ocen 1–5. Średnia liczy się tylko z widocznych recenzji i przelicza się po każdym zapisie, usunięciu, ukryciu i przywróceniu.

Odpowiedź autora

Autor modułu (członek namespace'u) albo moderator może odpowiedzieć na recenzję. Recenzja ma jedną odpowiedź — kolejna ją zastępuje; odpowiedź da się też usunąć. Odpowiedź widać pod recenzją z nazwą konta odpowiadającego.

Ukrywanie

Autor modułu albo moderator może recenzję ukryć (z opcjonalnym powodem, do 200 znaków) i później przywrócić.

• Ukryta recenzja znika z listy publicznej i nie liczy się do średniej.
• Autor recenzji nadal ją widzi, razem z powodem ukrycia. Nie może jej edytować, może ją usunąć.
• Autor modułu i moderator widzą wszystkie recenzje modułu, także ukryte, w panelu dewelopera.

Pytania pod modułem

Zakładka Pytania (?tab=questions) to pytania do autora razem z odpowiedziami. Jeden wątek = pytanie i lista odpowiedzi, bez odpowiedzi zagnieżdżonych.

Od pytania do publikacji

1. Zadajesz pytanie pod opublikowanym modułem (markdown, do 4000 znaków). Pytanie dostaje status oczekuje (pending) i nie jest jeszcze publiczne.
2. Akceptacja. Autor modułu (członek namespace'u) albo moderator pytanie publikuje (published) albo odrzuca (rejected). Decyzję można zmienić między „opublikowane” i „odrzucone” (także odrzucone opublikować później); powrotu do „oczekuje” nie ma.
3. Publikacja. Opublikowane pytanie widzą wszyscy na karcie modułu.

Status swoich pytań — także oczekujących i odrzuconych — widzisz w sekcji „Twoje pytania” na karcie modułu, po zalogowaniu.

Odpowiedzi

• Odpowiedzieć może każdy zalogowany użytkownik, ale tylko na pytanie opublikowane.
• Odpowiedź członka namespace'u modułu ma oznaczenie autora modułu (liczy się członkostwo w chwili odpowiedzi; moderator spoza namespace'u go nie dostaje).
• Odpowiedzi są w kolejności dodania.

Edycja i usuwanie

• Własne pytanie i własną odpowiedź możesz poprawić albo usunąć. Edycja nie zmienia statusu — opublikowane pytanie po poprawce zostaje opublikowane.
• Autor modułu i moderator usuwają dowolne pytanie i odpowiedź pod modułem. Nie poprawiają cudzych treści.
• Usuniętych treści nie da się przywrócić — znikają z karty modułu i z list.

Kolejka dla autora i moderatora

Autor modułu przegląda pytania swojego modułu (z filtrem statusu: oczekujące, opublikowane, odrzucone) w panelu dewelopera i tam je akceptuje, odrzuca i usuwa. Moderator ma jedną kolejkę oczekujących pytań ze wszystkich modułów, od najstarszego.

Forum

Forum (https://modules.orbito.pl/forum) to rozmowy niezwiązane z jednym pytaniem do autora: pomoc, pomysły, wdrożenia, tematy dla deweloperów.

Kategorie

Forum ma stałą listę kategorii zarządzaną przez moderatorów. Na start:

Lista kategorii pokazuje liczbę wątków i ostatni aktywny wątek.

Wątki i posty

• Wątek zakłada zalogowany użytkownik: kategoria, tytuł (do 160 znaków), treść w markdownie (do 20 000 znaków), do 5 tagów (małe litery, każdy do 30 znaków) i opcjonalnie moduł, którego dotyczy (tylko opublikowany). Wątki powiązane z modułem można filtrować po module.
• Posty (odpowiedzi w wątku) to markdown do 20 000 znaków, bez obrazków.
• Własny wątek i post poprawisz albo usuniesz; poprawki są niemożliwe w wątku zablokowanym.
• Rozwiązanie: autor wątku może oznaczyć jeden post jako rozwiązanie (i zdjąć oznaczenie). Usunięcie tego posta zdejmuje oznaczenie.
• Lista wątków: filtr kategorii, tagu i modułu, wyszukiwanie w tytule i treści, sortowanie aktywne (ostatnia odpowiedź, domyślnie), najnowsze i najwięcej postów. Przypięte wątki są zawsze na górze.

Moderacja

Moderator nie poprawia cudzych treści — może je tylko usunąć. Usunięte wątki i posty znikają z list i liczników.