Przejdź do głównej zawartości

Redakcja i zapis danych

Techniczny: DraftAkceptacja: Approved

Jak napisać dłuższy materiał marki: artykuł, LP, ofertę, wyciąg dla zarządu i przewodnik pracownika. Obejmuje też zapis liczb, kwot i dat, bo w materiale sprzedażowym to one najczęściej zmieniają sens. Teksty interfejsu i wiadomości operacyjne mają własną stronę: mikrocopy.

Każdy materiał, który ma kogoś przekonać, układa się według PWE: problem klienta jego językiem, nasza wartość w tej sytuacji, efekt po wszystkim. PWE jest kolejnością myślenia, nie trzema nagłówkami na ekranie. Definicja i granice: platforma marki.

MateriałOtwieraNiesieKończy
Artykułpytanie w nagłówku i odpowiedź w pierwszym akapiciesytuacje i szkody z konkretnego zawodu, warunki, liczby ze źródłemco sprawdzić dalej oraz sekcja „Źródła”
LP zawodunazwany zawód i to, co mu grozimapa ochrony, powód propozycji, cena i kompromiswejście do wyceny
LP produktuco produkt obejmuje i czego nie obejmujezakres, wyłączenia i limity spisane z OWU, przykład sytuacjiwejście do wyceny
Ofertarekomendacja i jej powódporównanie istotnych warunków, koszt, kompromiswybór klienta i następny krok
Wyciąg dla zarządurekomendacja, koszt roczny, najważniejszy kompromisróżnica wobec tego, co firma ma dziśdecyzja do podjęcia i jej termin
Przewodnik pracownikaz czego korzystasz i od kiedyjak umówić wizytę, gdzie pytać, co jest poza zakresempierwszy krok do wykonania

Zaczynamy od rzeczy, po którą klient przyszedł. Rozpoznanie sytuacji, uzasadnienie i przejrzysty przebieg pokazujemy po drodze, a nie jako produkt.

  • H1 niesie frazę, po której klient szuka.
  • H2 stawiamy co 200–300 słów i formułujemy jako realne pytanie.
  • Pierwsze zdanie sekcji odpowiada na jej nagłówek.
  • Sekcja ma się bronić bez sąsiednich sekcji.
  • FAQ liczy 3–5 pytań, które klient naprawdę zadaje.
  • Materiał kończy sekcja „Źródła”.

Wymogi widoczności treści dla wyszukiwarek i modeli, dane autora i recenzenta oraz schema opisuje strategia serwisu — źródło w repo: company/strategy/06-serwis-graf-seo-geo.md. Nie powtarzamy ich tutaj, żeby nie powstała druga wersja tych reguł.

Zdanie do 20 słów, akapit do 4 zdań. Dłuższe zdanie ma sens, gdy warunek traci znaczenie po rozbiciu; w materiale dla zarządu zdarza się to częściej niż w artykule. Czasownik jest krótszy od rzeczownika odczasownikowego: piszemy „przeanalizowaliśmy Twoją działalność”, nie „dokonaliśmy analizy działalności”. Myślnik nie jest domyślnym łącznikiem, wcześniej próbujemy kropki, przecinka i dwukropka. Reszta reguł polszczyzny: głos marki.

Zdanie z dokumentu przepisujemy na ludzkie, zachowując warunek:

Przed: „Zgodnie z warunkami ubezpieczenia zakres ochrony obejmuje odpowiedzialność cywilną z tytułu wykonywania zawodu, z zastrzeżeniem wyłączeń określonych w §15.”

Po: „Ochrona działa, gdy popełnisz błąd w swojej pracy. ⟦Liczba⟧ sytuacji nie obejmuje. Sprawdź je, zanim będą Ci potrzebne: ⟦wyłączenia z §15 OWU⟧.”

To przykład rejestru, nie twierdzenie o ofercie. Zdanie o zakresie wchodzi do materiału dopiero z konkretnego OWU, z numerem paragrafu i wersją dokumentu.

Materiał ma rozpoznać sytuację, zanim nazwie ubezpieczenie. Zdanie nazywa to, co klientowi może się przydarzyć w jego pracy, a nie kategorię ochrony.

ZamiastPiszemy (przykład rejestru)
„ryzyka związane z prowadzeniem działalności w branży IT”„Klient zgłasza wyciek danych z systemu, który utrzymujesz.”
„ochrona odpowiedzialności w usługach sportowych”„Kursantka łamie nogę na Twoich zajęciach.”
„ryzyko błędu w usługach księgowych”„Błąd w deklaracji, którą składasz za klienta.”

Konsekwencję finansową dopisujemy tylko ze źródła: z biblioteki szkód, z wyroku albo z danych klienta. Bez źródła w materiale zostaje sama sytuacja.

Każda liczba w materiale ma źródło. Liczba bez źródła nie wchodzi do publikacji; w dokumencie roboczym oznaczamy ją jako założenie i zamykamy przed wydaniem.

ElementZapisCzęsty błąd
Liczbytysiące dzielone spacją, przecinek dziesiętnyzapis, który czyta się jako inny rząd wielkości
Kwotykwota, waluta i okres albo liczba ratsama kwota, bez informacji, czy dotyczy miesiąca, roku czy raty
Procentywartość i podstawa: procent czego i za jaki okresprocent bez mianownika, porównanie bez okresu
Datyw zdaniu „19 września 2026”, w zwartej tabeli „19.09.2026”zapis „09/10”, który da się odczytać dwojako
Przedziały„20–50 pracowników”, przy kwocie wspólna waluta i okreszakres bez jednostki, nieoznaczone zaokrąglenie
Skrótypełna nazwa przy pierwszym użyciuwymaganie od klienta, żeby znał APK, OWU albo UD
Linki„Przeczytaj warunki ubezpieczenia”, z oznaczeniem pliku do pobrania„Kliknij tutaj” bez informacji, dokąd prowadzi
Listyjedna konstrukcja gramatyczna, pełne zdania z kropkącechy, polecenia i obietnice wymieszane w jednej liście

„1 200 zł rocznie” i „100 zł miesięcznie” pokazują zapis, nie cenę produktu ani relację ratalną jednej oferty. Raty wyliczamy wyłącznie z warunków tej oferty.

Czas i pieniądz mają własny zapis w danych — wyznacza go paczka @zendev/kernel (adr-009 — źródło w repo: company/adr/009-platforma-z-paczek-kuzni.md). Sformatowany tekst ich nie zastępuje. „Dziś” i „jutro” nie zastępują daty ważności oferty ani terminu płatności, a godziny granicznej nie dopisujemy z głowy.

KlientPrzedsiębiorcaPracodawcaKlient indywidualny
Materiałartykuł sytuacyjny, LP zawodu, LP produktu, ofertaporównanie pakietów, wyciąg dla zarządu, ściąga dla HR, przewodnik pracownikastrona produktu i kalkulator
Językzawód klienta, druga osobado HR „Ty”, o organizacji „firma” i „zespół”, do zarządu rzeczowo o firmieprosto i zadaniowo
Musi być widocznepowód propozycji, cena, kompromis, następny krokkoszt roczny, różnica wobec obecnego pakietu, podział pracy przy wdrożeniuwarunki i cena przed wyborem
Czego nie przenosimyjęzyka korporacyjnego z materiałów dla zarządutempa samoobsługi z materiałów dla przedsiębiorcyclaimu B2B, mapy potrzeb i wdrożenia

Pracownik objęty pakietem firmowym czyta materiały pracodawcy, nie materiały klienta indywidualnego.

Każdy artykuł kończy się tym zdaniem, w tym brzmieniu:

Artykuł ma charakter informacyjny. Nie jest rekomendacją ubezpieczenia ani poradą prawną. O zakresie ochrony decydują warunki ubezpieczenia konkretnego towarzystwa. Propozycję dla swojej sytuacji dostaniesz po Analizie Potrzeb Klienta.

Nie piszemy „skontaktuj się z doradcą”: Polisoteka® jest multiagencją, a słowo „doradca” sugeruje niezależne doradztwo. Stopka nie naprawia treści. Opis zakresu ochrony w artykule i tak pochodzi z warunków ubezpieczenia.

Podpis pochodzi z metadanych artykułu. Są dwie postaci: jeden autor albo redakcja i autor. Recenzentowi ani autorowi nie dopisujemy tytułów i uprawnień, których metadane nie niosą.

  • Zdanie o zakresie, wyłączeniu, limicie i cenie pochodzi z OWU, IPID albo oferty w wersji, którą dostaje klient.
  • Zdanie o efekcie pochodzi z pomiaru. Hipotezy nie publikujemy jako wyniku.
  • Skracanie tekstu nie usuwa zastrzeżenia, które zmienia sens oferty.
  • Cytat, dokument formalny i wymagane oświadczenie zostają bez zmian.
  • Rozróżniamy cenę wstępną, cenę oferty, ratę i opłatę dodatkową. Stan „brak odpowiedzi” nie staje się „odmową”, żeby skrócić tabelę.
  • Rekomendację albo odradzenie produktu zatwierdza człowiek.

Zakazane zwroty trzyma blacklista głosu.

Materiał jest gotowy, gdy na nim widać:

  1. do którego kontekstu należy i że nie pożycza obietnic z innego;
  2. sytuację klienta nazwaną jego zawodem, nie kategorią ubezpieczenia;
  3. powód propozycji i kompromis bez otwierania rozwinięć;
  4. źródło przy każdej liczbie i przy każdym zdaniu o zakresie ochrony;
  5. następny krok klienta.

Ten sam zapis kwoty, okresu i daty sprawdzamy na komplecie: oferta i wiadomość do klienta muszą znaczyć to samo. W interfejsie testujemy długą kwotę i długą nazwę: informacji nie skracamy po to, żeby zmieściła się w komponencie. Przed publikacją materiał przechodzi audyt języka.

Głos marki, słownik, strategia serwisu — źródło w repo: company/strategy/06-serwis-graf-seo-geo.md, zapis czasu i kwot — źródło w repo: company/adr/009-platforma-z-paczek-kuzni.md, ścieżka JDG — źródło w repo: company/strategy/sciezka-zakupowa-jdg-big-picture.md, ścieżka zdrowia — źródło w repo: company/strategy/sciezka-zakupowa-zdrowie-big-picture.md.