Po co w ogóle instrukcja
Instrukcja to nie esej. Nikt nie czyta jej dla przyjemności. Sięgasz po nią, gdy chcesz coś zrobić i nie chcesz tracić czasu. Dlatego dobra instrukcja robi dwie rzeczy: prowadzi Cię za rękę i nie myli kroków. Brzmi prosto? Bo takie ma być.
Czy musisz znać trudne słowa i formaty? Nie. Wystarczy, że od początku wiesz, do czego prowadzisz, i układasz drogę małymi, jasnymi krokami. Resztę – ozdobniki, dygresje – świadomie pomijamy.
Rdzeń instrukcji w 4 krokach
Najpierw określ, co ma się wydarzyć na końcu. Chcesz, żeby ktoś złożył krzesło, wysłał podanie przez ePUAP albo upiekł ciasto? Finał musi być jeden i konkretny. Potem przejdź przez proste etapy.
- Cel i warunki startu: napisz jednym zdaniem, co będzie efektem i co trzeba mieć na początku. Przykład: „Upieczesz prosty chleb. Potrzebujesz miski, piekarnika i 15 min na wyrabianie”.
- Lista kroków: każdy krok to jedna czynność, zaczyna się czasownikiem: „Włącz”, „Wsyp”, „Kliknij”. Unikaj dwóch rzeczy w jednym punkcie. Jeśli trzeba – rozbij.
- Ostrzeżenia i pułapki na czas: jeśli jest moment, w którym łatwo coś zepsuć, powiedz to wtedy, nie po wszystkim. „Nie mieszaj po dodaniu piany – opadnie”.
- Efekt i szybkie sprawdzenie: zakończ krótkim testem „czy wyszło”. „Chleb jest gotowy, gdy stukany od spodu wydaje głuchy dźwięk”.
Język, który nie przeszkadza
Jak pisać, żeby nie trzeba było dwa razy czytać? Po pierwsze, czasowniki na początek: „Otwórz aplikację”, „Wybierz zakładkę”. To działa jak drogowskaz. Po drugie, zdania krótkie. Jedno zdanie = jedna myśl. Jeśli czujesz przecinek na przecinku, to znak, że robisz za dużo na raz.
Żargon? Tylko jeśli musisz – i od razu wyjaśnij. Zamiast „autoryzuj tożsamość”, napisz „potwierdź, że to Ty – wpisz kod z SMS-a”. Widzisz różnicę? Czytelnik też.
Kolejność ma znaczenie. Najpierw mówisz, co zrobić, potem dlaczego. Ktoś w trakcie działania nie chce wykładu, chce wiedzieć, co kliknąć. Uzasadnienia i ciekawostki możesz dodać na końcu, w osobnej sekcji „Dlaczego tak?”. Jeśli w ogóle są potrzebne.
Test chodnikowy i skracanie
Masz wersję roboczą? Zrób prosty test. Daj instrukcję osobie, która „nie była przy tym projekcie”. Niech zrobi to, co opisujesz, bez pytań do Ciebie. Gdzie utknie – tam popraw tekst. To najszybsza metoda.
Nie masz kogo poprosić? Przejdź sam. Głośno czytaj i wykonuj kroki dosłownie. Jeśli łapiesz się na „wiadomo, że trzeba…”, to właśnie nie wiadomo. Dopisz to zdanie.
Na koniec skracanie. Zasada jest prosta: każde słowo pracuje albo wylatuje. „Należy wprowadzić dane w odpowiednie pola” zamień na „Wpisz dane w pola”. Efekt? Lżej, szybciej, czytelniej.
Mini-przykład w praktyce
Załóżmy, że opisujesz wysyłkę pracy przez platformę.
Cel: „Wyślesz plik z wypracowaniem do nauczyciela”. Warunki startu: „Masz gotowy plik PDF i dostęp do internetu”.
Kroki: „1) Wejdź na platformę. 2) Zaloguj się. 3) Otwórz zadanie ‘Wypracowanie’. 4) Kliknij ‘Prześlij plik’. 5) Wybierz PDF i zatwierdź. 6) Sprawdź, czy obok zadania widzisz ‘Przesłano’”. Ostrzeżenie na czas: „Nie zamykaj karty przed pojawieniem się komunikatu ‘Przesłano’ – inaczej plik się nie zapisze”. Test: „Jeśli widzisz datę i nazwę pliku pod zadaniem – wszystko jest OK”.
Podsumowując: dobra instrukcja to cel na start, kroki po kolei, ostrzeżenia wtedy, gdy są potrzebne, i krótki test na koniec. Bez fajerwerków. Ma działać, nie błyszczeć.
Chcesz szybko przerobić szkic instrukcji na jasne kroki albo wygenerować wersję w innym języku? Wskocz do aplikacji i zobacz, jak to przyspiesza pracę.