Instrukcja produktu na stronie: pierwsze uruchomienie bez zgadywania

Pudełko jest otwarte. Wszystkie elementy wyglądają znajomo, poza jednym, który wyraźnie wygląda na ważny. Na stronie produktu znajduje się piękny opis idei, trzy zdjęcia wnętrza i przycisk pobrania pliku „Instrukcja_final_poprawiona_2”. W tej chwili klient potrzebuje jednak odpowiedzi na znacznie skromniejsze pytanie: od czego zacząć, żeby nie rozłożyć wszystkiego na podłodze drugi raz.

Instrukcja pierwszego uruchomienia ma przeprowadzić człowieka od otrzymanego produktu do pierwszego rozpoznawalnego rezultatu. Nie musi zawierać całej historii jego powstania ani zastępować kompletnej dokumentacji producenta. Powinna wskazać właściwy wariant, przygotowanie, kolejność czynności i sposób sprawdzenia, czy najważniejszy etap się udał.

Weźmy fikcyjny organizer biurkowy: podstawę, dwie przegrody i wkład na drobne przedmioty. Produkt jest prosty, bez instalacji elektrycznej i bez czynności wymagających szczególnych kwalifikacji. To wygodny przykład redakcyjny. Przy rzeczywistym wyrobie treść techniczną, ostrzeżenia i dopuszczalny sposób użycia musi zatwierdzić osoba odpowiedzialna za produkt. Projektant strony układa tę wiedzę w czytelną drogę.

Zacznij przy pudełku, nie przy strukturze firmowego dysku

Przed pisaniem odtwórz pierwsze spotkanie z produktem. Co człowiek ma przed sobą? Jak rozpozna model? Które elementy są podobne? Czy opakowanie zawiera nazwę zgodną z kartą produktu? Jeżeli trzeba znać wewnętrzny kod katalogowy, żeby odnaleźć instrukcję, popraw najpierw drogę identyfikacji.

Dla naszego organizera otwarcie instrukcji mogłoby pokazać zdjęcie zestawu rozłożonego na jasnym tle i nazwy trzech rodzajów elementów. Liczba sztuk ma być widoczna obok nazwy. Sam elegancki rysunek nie rozstrzyga, czy druga przegroda zaginęła, czy nigdy nie należała do tej wersji.

Podaj, dla jakiego wariantu powstała instrukcja. Rozmiar podstawy albo sposób mocowania może odróżniać dwie niemal identyczne wersje. Nie zmuszaj klienta do rozpoczęcia procedury, zanim odkryje tę różnicę w kroku szóstym. Jeśli wspólny materiał obejmuje kilka wersji, wyjaśnij wybór drogi na początku i oznacz późniejsze różnice konsekwentnie.

Nazwy elementów powinny pasować do oznaczeń w pudełku i na rysunkach. „Listwa”, „przegroda” i „wspornik” mogą w rozmowie zespołu oznaczać tę samą część, lecz początkujący odbiorca tego nie wie. Wybierz jedno określenie oraz ewentualny kod. Kod pomaga wskazać element, a nazwa wyjaśnia jego rolę.

Zapisz rzeczy potrzebne przed rozpoczęciem. W naszym przykładzie będzie to wolny fragment stołu i sprawdzenie zawartości zestawu. W innym produkcie zakres przygotowania może być inny. Nie kopiuj do instrukcji listy narzędzi z podobnej realizacji. Każda wymieniona rzecz powinna wynikać z zatwierdzonej procedury.

Warto też wskazać moment, w którym należy przerwać. Jeżeli część nie pasuje do pokazanego wariantu albo czegoś brakuje, odbiorca powinien wiedzieć, jak uzyskać wyjaśnienie. Instrukcja nie może z góry zakładać, że każdą przeszkodę trzeba pokonać większą siłą i jeszcze większym zaufaniem do ilustracji.

Odnalezienie materiału jest częścią projektu. Jeżeli odsyłasz z opakowania lub papierowej wkładki, sprawdź cel kodu QR prowadzącego do strony, również dla właściwego wariantu instrukcji. Link może pojawić się na karcie produktu, w sekcji pomocy i w wiadomości transakcyjnej po zakupie. Każda droga powinna prowadzić do właściwej wersji. Odbiorca często wraca do instrukcji znacznie później, bez pamiętania, w której wiadomości została wysłana.

Nie wymagaj ponownego podawania danych zamówienia tylko po to, żeby przeczytać publiczną instrukcję. Jeśli materiał wymaga innego sposobu dostępu, wyjaśnij go jasno. Klient ma rozpoznać procedurę dotarcia do wiedzy, zanim zacznie diagnozować sam produkt.

Rozpisz pierwsze trzy czynności

Robocza wersja dla fikcyjnego organizera może wyglądać tak:

1. Sprawdź zawartość zestawu według zdjęcia. W zestawie powinny znajdować się podstawa, dwie jednakowe przegrody i jeden wkład.
2. Ustaw podstawę na stole zgodnie z oznaczeniem na rysunku. Znacznik frontu powinien znajdować się po stronie pokazanej na ilustracji.
3. Umieść pierwszą przegrodę w oznaczonym miejscu. Porównaj jej położenie z widokiem gotowego etapu, zanim dodasz drugą.

To przykład sposobu zapisu, a nie instrukcja dla istniejącego wyrobu. Każdy krok ma czynność oraz warunek sprawdzenia. W rzeczywistym materiale trzeba dodać zatwierdzone informacje wynikające z konstrukcji. Dzięki rozdzieleniu łatwiej zauważyć, czego brakuje: odbiorca może wiedzieć, co zrobić, ale nadal nie wiedzieć, czy zrobił to poprawnie.

Wskazówki redakcyjne WordPress dotyczące procedur zalecają kolejność zgodną z wykonaniem i zakończenie określonym działaniem lub wynikiem. To reguły dla dokumentacji tej platformy. Przy produkcie fizycznym wykorzystujemy tu jedynie zasadę czytelnej sekwencji, a treść czynności pozostaje wiedzą producenta.

Nie mieszaj kilku niezależnych działań w jednym długim kroku. Jeśli odbiorca odkłada telefon, wykonuje czynność i wraca, powinien łatwo odnaleźć miejsce. Z drugiej strony rozbijanie każdego drobnego ruchu na osobny ekran może utrudnić zrozumienie całości. Granicę wyznacza etap, który da się rozpoznać oraz sprawdzić.

Zaplanuj również powrót po przerwie. Nazwa etapu i widok aktualnego stanu pozwalają rozpoznać, czy pierwsza przegroda została już dodana. W dłuższej procedurze przydatny może być spis etapów, lecz nie powinien sugerować zakończenia czynności, których system nie obserwuje. Samo otwarcie kolejnego akapitu nie dowodzi wykonania pracy przy produkcie. Oznaczenie postępu ma pomagać odbiorcy, a nie tworzyć pozorne potwierdzenia.

Podaj przewidywany rezultat tam, gdzie człowiek go potrzebuje. Zdanie „Przegroda powinna znajdować się w pokazanym położeniu” przy odpowiednim obrazie pomaga od razu. Ogólne „Po poprawnym montażu produkt jest gotowy” na końcu strony nie pomaga znaleźć pomyłki powstałej kilka minut wcześniej.

Obraz ma pokazać dokładnie tę czynność, o której mówi tekst

Fotografia otwierająca może przedstawić gotowy organizer w użyciu. Przy kroku potrzebny jest jednak inny kadr: właściwa część, miejsce połączenia i orientacja elementu. Nie traktuj zdjęć instruktażowych jak odrzuconych zdjęć kampanii. Mają własną pracę do wykonania.

Zachowaj czytelny punkt odniesienia między ujęciami. Jeśli produkt nagle obraca się o pół obrotu, oznacz tę zmianę lub pokaż szerszy widok. Autor zna przedmiot i bez trudu odtwarza orientację. Odbiorca może w tym samym momencie trzymać podstawę odwrotnie i porównywać dwa podobne otwory.

W pomocy iFixit dotyczącej kroków poradnika tytuł kroku ma wyjaśniać jego treść, a oznaczenia obrazu można powiązać z odpowiednimi punktami tekstu. To przykład spójnego powiązania elementów instrukcji. Nie trzeba kopiować konkretnej kolorystyki, by zastosować tę relację we własnym materiale.

Jeżeli używasz oznaczeń, zachowaj ich znaczenie. Strzałka wskazująca ruch nie powinna na kolejnym obrazie oznaczać dowolnego detalu. Numer części nie może konkurować z numerem kroku. Przy odbiorze poproś osobę spoza projektu, żeby wskazała, czego dotyczy każdy znacznik, zanim zacznie działać.

Kolor może wspierać rozróżnienie, ale dopisz nazwę lub numer także w tekście. „Włóż element zaznaczony na zielono” zależy od odczytania koloru. „Włóż przegrodę A w miejsce A” daje dodatkową drogę rozpoznania. Właściwe oznaczenia trzeba sprawdzić również w wydruku, jeżeli producent przewiduje taką formę korzystania.

Na telefonie pokaż detal w skali umożliwiającej odczytanie. Sam plik wysokiej rozdzielczości nie wystarczy, jeśli strona wyświetla go jako wąski pasek. Powiększenie powinno pozwolić wrócić do tego samego kroku. Odbiorca nie powinien po obejrzeniu szczegółu lądować na początku całej instrukcji.

Krótki film przydaje się, gdy sens tkwi w ruchu. Zadbaj jednak o możliwość zatrzymania i odnalezienia ważnego momentu. Zwykły zapis czynności nadal pomaga wrócić do kroku bez ponownego oglądania całości. Decyzję warto powiązać z osadzaniem wideo na stronie usługowej, szczególnie gdy materiał ma być używany na wąskim ekranie.

Format publikacji wybierz według sytuacji. HTML ułatwia bezpośrednie odsyłanie do treści i dopasowanie widoku. PDF może odpowiadać potrzebie pobrania lub wydruku, ale wymaga własnego przygotowania. Przy wyborze PDF albo HTML nie zakładaj, że dodanie dowolnego pliku kończy projekt instrukcji.

Jeżeli udostępniasz obie formy, ustal wspólne źródło lub procedurę ich aktualizacji. Dwa osobno utrzymywane materiały łatwo rozjeżdżają się po zmianie jednego elementu. Klient nie powinien rozstrzygać, czy bardziej aktualna jest data na stronie, nazwa pliku czy obraz w wiadomości.

Przy projekcie strony Aeneia Design może pomóc nadać zatwierdzonym materiałom czytelną strukturę i miejsce w drodze klienta.

Sprawdź instrukcję przy rzeczywistym zadaniu

Do testu przygotuj także niepasującą wersję instrukcji i sprawdź, czy uczestnik rozpoznaje różnicę przed rozpoczęciem. Nie trzeba wykonywać błędnej czynności. Wystarczy poprosić o wybór właściwego materiału na podstawie oznaczenia produktu. Taka próba ujawnia, czy nazwy wersji i obrazy otwierające rzeczywiście chronią przed pomyłką, czy jedynie dobrze wyglądają obok siebie w katalogu.

Do testu potrzebujesz produktu albo wiarygodnego odwzorowania czynności, aktualnej instrukcji i osoby o doświadczeniu zbliżonym do przyszłego odbiorcy. Autor materiału powinien obserwować. Jeśli przez cały czas tłumaczy, gdzie patrzeć, sprawdza przede wszystkim własną cierpliwość, a nie samodzielność instrukcji.

Zapisuj momenty zatrzymania: nierozpoznany element, niejasny kadr, brak potwierdzenia albo trudność w powrocie do kroku. Nie nazywaj każdej pauzy błędem. Człowiek może po prostu uważnie porównywać obraz z przedmiotem. Problem zaczyna się wtedy, gdy materiał nie daje mu potrzebnej odpowiedzi i musi zgadywać.

Po wykonaniu etapu poproś o wskazanie, po czym uczestnik rozpoznał sukces. Jeśli odpowiada „wyglądało mniej więcej dobrze”, sprawdź, czy instrukcja pokazuje dostatecznie konkretny rezultat. Nie dokładaj od razu kolejnego ostrzeżenia. Być może wystarczy lepszy widok gotowego połączenia albo prostsza nazwa części.

Oddziel brak wiedzy od problemu języka. Jeżeli czynność wymaga specjalistycznego przygotowania, ładniejszy tekst go nie zastąpi. Jeśli natomiast odbiorca nie rozumie słowa używanego wyłącznie wewnątrz firmy, popraw nazewnictwo. W głosie marki w komunikatach interfejsu pomoc w zadaniu również ma pierwszeństwo przed ozdobnym charakterem wypowiedzi.

Pytania z próby mogą trafić do FAQ, lecz podstawowej czynności nie chowaj w odpowiedzi na końcu strony. Gdy kilka osób pyta, w którą stronę ustawić podstawę, popraw odpowiedni krok. Rozbudowanie listy częstych pytań nie powinno zastępować naprawy instrukcji.

Na zakończenie ustal właściciela materiału i powody przeglądu. Nowa wersja produktu, zmiana zawartości zestawu albo inne oznaczenie części powinny uruchamiać sprawdzenie instrukcji. Zapisz model, wersję i datę zatwierdzenia w miejscu, które pozwala odróżnić aktualny materiał od dawnego. „Final” w nazwie pliku jest wyrazem nadziei, nie systemem wersjonowania.

Dobra instrukcja pozwala zacząć, zatrzymać się i wrócić bez odtwarzania całej historii. Po pierwszym użyciu może być potrzebna ponownie, już przy innym pytaniu. Wtedy czytelne nazwy etapów i stabilne miejsce publikacji okazują się równie przydatne jak starannie przygotowany pierwszy kadr.