styl techniczny

Styl techniczny to sposób komunikacji operujący precyzyjną terminologią branżową.

Precyzja zamiast wrażeń

Komunikat techniczny opisuje stan urządzenia w sposób, który pozwala go odtworzyć: podaje dosłowne brzmienie błędu, jego numer, moment wystąpienia, wersję systemu i nazwę programu wraz z numerem wydania. Zdanie o tym, że komputer się zawiesza, nie niesie żadnej informacji diagnostycznej; zdanie o niebieskim ekranie z kodem zatrzymania odwołującym się do sterownika i o tym, że pojawia się wyłącznie przy podłączonej stacji dokującej, prowadzi wprost do przyczyny. Ta sama zasada dotyczy nazewnictwa: jeden byt ma jedną nazwę w całym dokumencie, więc raz wybrana forma nie zamienia się w kolejnym akapicie na potoczny zamiennik.

Skąd wziąć dane, które warto podać

Wersję systemu pokazuje polecenie winver, konfigurację sprzętu i sterowników karty graficznej narzędzie dxdiag, a listę zdarzeń poprzedzających awarię Podgląd zdarzeń, gdzie liczy się źródło wpisu i jego identyfikator, nie sama treść po polsku. Zrzut ekranu z komunikatem robi się skrótem z klawiszem Windows, klawiszem Shift i literą S, dzięki czemu można wyciąć sam fragment okna. Warto zapisywać komunikat w oryginalnym brzmieniu — przetłumaczone wersje bywają nie do znalezienia w bazach wiedzy, podczas gdy angielski oryginał albo sam kod prowadzi do konkretnego opisu. Styl techniczny nie znaczy przy tym styl niezrozumiały: dobra notatka serwisowa ma warstwę faktów i jedno zdanie wyjaśniające, co z nich wynika dla użytkownika.

Błędy, które wydłużają naprawę

Zgłoszenie opisujące emocje zamiast objawów wymusza powtórzenie całej diagnostyki od zera. Podobnie działa relacja z drugiej ręki, w której pracownik przekazuje to, co usłyszał od kolegi, gubiąc po drodze treść komunikatu. Trzecim problemem jest przemilczenie zmian: nikt nie wspomina o aktualizacji sterownika ani o nowym programie zainstalowanym w zeszłym tygodniu, choć to zwykle najważniejsza informacja w całym zgłoszeniu. Po stronie serwisu ekwiwalentnym grzechem jest opis naprawy pełen skrótów, z którego klient nie dowiaduje się, co zostało wymienione i dlaczego.

Jak przygotować zgłoszenie, żeby naprawa poszła szybciej

Prosimy o trzy rzeczy: dokładny komunikat lub jego zdjęcie, opis czynności, po której problem występuje, oraz informację, co zmieniło się na komputerze tuż przed awarią. Przy sprzęcie firmowym przydaje się jeszcze nazwa stanowiska i wersja programu handlowego. Sami dokumentujemy przebieg naprawy językiem, który da się zrozumieć bez wykształcenia informatycznego, ale bez zaokrąglania faktów. Zgłoszenia przyjmujemy przez całą dobę, również w weekendy.