| Termin | Definicja |
|---|---|
| Poziom trudności tekstu | Poziom trudności tekstu to wskaźnik oceniający, jak łatwo dokument jest zrozumiały dla przeciętnego odbiorcy. Co oznacza poziom trudności tekstuPoziom trudności tekstu to miara opisująca, jak łatwo przeciętny odbiorca może zrozumieć dokument podczas samodzielnego czytania. W informatyce pojęcie to odnosi się między innymi do instrukcji obsługi, komunikatów systemowych, opisów funkcji programu, dokumentacji sterowników oraz treści wyświetlanych przez aplikacje serwisowe. Nie jest to ocena poprawności technicznej dokumentu ani miara wydajności komputera. Tekst może zawierać prawidłowe informacje, a jednocześnie być trudny w odbiorze z powodu długich zdań, specjalistycznego słownictwa lub niejasnej kolejności poleceń. Na trudność wpływa kilka cech językowych. Krótkie zdania z jasno wskazanym wykonawcą czynności są zwykle łatwiejsze do zrozumienia niż zdania wielokrotnie złożone. Znaczenie ma także liczba pojęć technicznych, skrótów, nazw parametrów i założeń pozostawionych bez wyjaśnienia. W instrukcji dotyczącej laptopa różnicę robi sposób opisania tej samej czynności: komunikat „Podłącz zasilacz i uruchom komputer” jest prostszy niż opis zawierający kilka warunków, wyjątków i odwołań do nazw modułów systemowych. Jak ocenia się czytelność dokumentuPoziom trudności można szacować za pomocą indeksów czytelności. Takie wskaźniki analizują przede wszystkim długość zdań, długość wyrazów, liczbę sylab albo udział trudniejszych konstrukcji składniowych. Wynik nie opisuje bezpośrednio jakości treści, lecz pozwala porównywać dokumenty przygotowane według podobnych zasad. W polskich tekstach można spotkać między innymi indeks FOG-PL, który wykorzystuje długość zdań i długość wyrazów do przybliżenia wymaganego poziomu wykształcenia czytelnika. Każdy indeks ma własny wzór, dlatego wyników różnych metod nie należy utożsamiać bez sprawdzenia ich definicji. Automatyczna analiza może wykryć zdania o dużej liczbie słów, nadmiar rzeczowników odczasownikowych, częste użycie strony biernej lub nagromadzenie terminów. Narzędzie oceniające czytelność nie rozumie jednak znaczenia dokumentu tak jak człowiek. Może uznać poprawną instrukcję za trudną, ponieważ zawiera konieczne nazwy techniczne, na przykład „sterownik kontrolera pamięci masowej” albo „partycja systemowa”. Z tego powodu wynik wskaźnika powinien być traktowany jako pomoc redakcyjna, a nie jako samodzielny dowód, że dokument jest zrozumiały albo niezrozumiały. Trudność instrukcji a czynności przy komputerzeW dokumentacji laptopa lub komputera PC poziom trudności powinien odpowiadać osobie, która ma wykonać opisaną czynność. Instrukcja dla użytkownika domowego powinna wyjaśniać kolejność działań, wskazywać nazwy elementów widocznych na ekranie i rozdzielać czynności obowiązkowe od opcjonalnych. Jeżeli tekst opisuje aktualizację sterownika, warto jasno podać, gdzie znajduje się właściwe urządzenie, jaki plik należy uruchomić i po czym rozpoznać zakończenie procesu. Samo polecenie „zainstaluj najnowszy sterownik” nie określa źródła pliku, sposobu weryfikacji ani oczekiwanego rezultatu. Trudność rośnie również wtedy, gdy jeden akapit miesza kilka poziomów działania. Osobno należy opisać objaw, możliwą przyczynę, czynność diagnostyczną i sposób interpretacji wyniku. Przykładowo instrukcja dotycząca problemu z dźwiękiem może najpierw polecić sprawdzenie wyciszenia, następnie wybór właściwego urządzenia wyjściowego, a dopiero później ponowne zainstalowanie sterownika audio. Taki układ ogranicza ryzyko wykonania zaawansowanej operacji przed sprawdzeniem prostych ustawień. Zrozumiałość poprawiają także listy kroków, konsekwentne nazewnictwo oraz jednoznaczne ostrzeżenia przy czynnościach mogących zmienić konfigurację systemu. Sprawdzanie zrozumiałości treści serwisowejPrzy ocenie tekstu serwisowego warto połączyć automatyczny wskaźnik z kontrolą merytoryczną. Należy sprawdzić, czy użyte nazwy odpowiadają rzeczywistym elementom systemu, czy polecenia występują we właściwej kolejności oraz czy opis nie pomija warunków wstępnych. Istotne jest również rozróżnienie komunikatu informacyjnego od instrukcji naprawczej. Zdanie „system wykrył urządzenie pamięci masowej” opisuje stan, natomiast zdanie „wyłącz komputer, odłącz zasilacz i sprawdź połączenie dysku” wskazuje działanie. Łączenie tych funkcji w jednym niejasnym akapicie utrudnia poprawne wykonanie czynności. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów, dlatego podczas serwisowania można również ocenić, czy instrukcje przekazane użytkownikowi opisują rozpoznany problem w sposób zrozumiały. Poziom trudności tekstu nie zastępuje diagnostyki sprzętu ani testów oprogramowania, ale pomaga ograniczyć błędy wynikające z nieprawidłowego odczytania komunikatu. Dobrze opracowana treść powinna pozwalać odbiorcy rozpoznać objaw, wykonać bezpieczne kroki i wiedzieć, kiedy potrzebna jest dalsza kontrola techniczna. |