Przejdź do treści

Treść

Jasno, spokojnie, konkretnie. Jak mówią produkty prfct — na przyciskach, w komunikatach o błędach, w stanach pustych i wszędzie pomiędzy.

Słowa to też interfejs. Precyzyjna etykieta sprawia, że podpowiedź staje się zbędna; dobry komunikat o błędzie — że zbędne staje się zgłoszenie do pomocy technicznej. Głos prfct jest jasny, spokojny i konkretny.

Głos

PiszemyNie piszemy
Jasno — prostymi słowami, krótkimi zdaniami, po jednej myśli naraz.Z wymuszonym dowcipem, zagadkowo ani żargonem.
Spokojnie — rzeczowo, nawet gdy coś pójdzie nie tak.Alarmistycznie, z pretensją ani z przesadnymi przeprosinami.
Konkretnie — nazywamy rzecz i jej skutek.Mgliście: coś poszło nie tak, element, dane.
Po ludzku — jak życzliwa osoba z zespołu.Urzędowo, maszynowo ani zbyt poufale.

Zasady redakcyjne

  • Wielka litera tylko na początku tytułu, przycisku, pozycji menu czy zakładki — dalej wyłącznie w nazwach własnych. Nie przenoś do polszczyzny angielskiego Title Case: Ustawienia konta, nie Ustawienia Konta.
  • Nazwę zawsze piszemy małymi literami — prfct — nawet na początku zdania, i nie odmieniamy jej: w prfct, z prfct. Strona to prfct.dev.
  • Liczby zapisuj cyframi: 3 pliki, nie trzy pliki. Cyfry grupuj niełamliwą spacją (12 500), część dziesiętną oddzielaj przecinkiem (4,5 MB) i formatuj liczby według ustawień regionalnych odbiorcy. Rzeczownik odmieniaj zgodnie z liczbą — 1 plik, 2 pliki, 5 plików — zamiast uciekać w plik(i).
  • Bez kropki w etykietach, na przyciskach, w nagłówkach i w jednozdaniowym tekście pomocniczym. W tekście z kilku zdań kropki stawiaj normalnie.
  • Polska interpunkcja: cudzysłów „…”, myślnik ze spacjami po obu stronach ( — ) i wielokropek jako jeden znak (Szukaj…).
  • Czasowniki zamiast rzeczowników: Nie udało się zapisać pliku, nie Wystąpił błąd zapisu pliku; Sprawdź adres, nie Dokonaj weryfikacji adresu. Tak mówi człowiek, a nie urząd.
  • Na „ty”: zwracaj się do ludzi w drugiej osobie i małą literą — to interfejs, nie list — a o produkcie mów my, ale oszczędnie. Unikaj form, które zakładają płeć (Zapisano zmiany, nie Zapisałeś zmiany), i pomijaj zaimki, gdy nic nie wnoszą (Zmień hasło, nie Zmień swoje hasło).
  • Daty i godziny podawaj względnie, gdy są świeże (2 minuty temu), a bezwzględnie, gdy są starsze (18 wrz 2026), z pełną wartością w podpowiedzi. Nazwy miesięcy piszemy małą literą, a godziny — w zapisie 24-godzinnym (14:30).

Akcje

Etykiety przycisków i pozycji menu zaczynaj od czasownika w trybie rozkazującym i nazywaj w nich obiekt: Utwórz projekt, Zaproś do zespołu, Eksportuj do CSV. Nie zastępuj czasownika rzeczownikiem ani bezokolicznikiem: Zapisz, nie Zapisywanie ani Zapisać. Ta sama akcja ma wszędzie tę samą etykietę.

ZamiastNapisz
OKZapisz zmiany
ZatwierdźUtwórz konto
Tak / NieUsuń projekt / Zachowaj projekt
Kliknij tutajPrzeczytaj przewodnik po migracji

Błędy

Dobry komunikat o błędzie mówi, co się stało, dlaczego (jeśli to pomaga) i co zrobić dalej — w tej kolejności i bez szukania winnych.

Dobrze.Konkretnie i z jasnym następnym krokiem.
Źle.Mgliście, technicznie i bez żadnej pomocy.
  • Waliduj po opuszczeniu pola, nie przy każdym naciśnięciu klawisza. Nie pokazuj błędu, dopóki ktoś jeszcze pisze.
  • Umieść komunikat przy problemie za pomocą FieldError, a w długich formularzach podsumuj błędy na górze.
  • Nigdy nie gub wpisanych danych. Błąd nie może wyczyścić formularza.

Stany puste

Stan pusty to zaproszenie, a nie brak. Wyjaśnij, co się tu pojawi, i zaproponuj pierwszą akcję: Nie masz jeszcze projektów — utwórz pierwszy, żeby zacząć wdrażać.

Potwierdzenie

Proś o potwierdzenie tylko wtedy, gdy akcja niszczy dane i nie da się jej cofnąć. Nazwij obiekt i skutek: Usunąć projekt „Acme website”? Usuniesz też 14 wdrożeń i nie da się tego cofnąć. Jeśli możesz zaoferować cofnięcie, wybierz je zamiast potwierdzenia.