Czym jest zweryfikowany walkthrough? Definicja i jak odróżnić go od demo

Co sprawia, że jest zweryfikowany

Cztery rzeczy i wszystkie cztery muszą być obecne. Jeśli brakuje którejkolwiek z nich, takie nagranie to demo, czyli coś innego i mniej użytecznego.

• Prawdziwy przebieg. Produkt był obsługiwany przed kamerą. Bez animacji, bez generowania, bez odtwarzania ze zrzutów ekranu.
• Dowód z produktu. Wynik jest porównywany z czymś, co produkt wytworzył niezależnie od klikanego ekranu: plikiem w zasobniku ze zgodną sumą kontrolną, alertem docierającym do innej skrzynki odbiorczej, przywróconą maszyną, która się uruchamia.
• Zachowane porażki. Wszystko, co poszło źle, zanim się udało, zostaje w logu i w wideo, razem z rozwiązaniem.
• Znacznik wersji. Kompilacja, na której wykonano przebieg, jest zapisana, więc gdy się zmieni, wideo można uruchomić ponownie, zamiast pozwolić mu się po cichu zestarzeć.

Co się nie liczy

• Demo. Przećwiczona ścieżka wykonana przez kogoś, kto już znał odpowiedź. Nie ma w tym nic fałszywego, ale to nie jest dowód.
• Wygenerowane wideo. Model wytworzył materiał na podstawie scenariusza. Taki materiał nigdy nie był ograniczony tym, co robi oprogramowanie, więc nie może być błędny, a zatem niczego nie weryfikuje.
• Slajdy z narracją, przydatne do objaśniania pojęć, ale bez działającego produktu.
• Nagranie ekranu wysłane jednej osobie. Dobre dla jednego odbiorcy, który zna kontekst. Nie zawiera wersji, wymagań wstępnych ani dowodów.

Jak w mniej więcej minutę odróżnić go od demo

Sześć pytań. Większość filmów o oprogramowaniu, także tych drogich, odpowiada na jedno lub dwa.

• Czy zadanie zostaje ukończone w momencie, który da się wskazać?
• Czy podano wersję produktu?
• Czy wymagania wstępne są pokazane na ekranie, zanim cokolwiek zostanie kliknięte?
• Czy jest dowód wytworzony przez produkt, a nie zapewnienie narratora, że się udało?
• Czy pokazano, że coś idzie nie tak?
• Czy widz może z tego skorzystać: czy obok wideo są spisane kroki?

Pełną, dziewięciopunktową listę kontrolną przed publikacją zawiera artykuł Co sprawia, że wideo marketingowe o oprogramowaniu jest dobre, a omówiony przykład z obydwoma zachowanymi niepowodzeniami to walkthrough instalacji Proxmox VE 9.2.

Dlaczego porażki mają znaczenie

Ludzie nie szukają frazy „jak skonfigurować X”. Szukają komunikatu błędu, kroku, który nie zadziałał, ustawienia, którego nikt nie udokumentował. Walkthrough, który zawiera porażkę i jej rozwiązanie, odpowiada na takie zapytanie. Dopracowane demo w ogóle na nie nie odpowiada i dlatego odpowiedź trafia zamiast tego na forum.

Pytania

Czy zweryfikowany walkthrough to to samo co demo produktu?

Nie. Demo pokazuje, że zadanie da się wykonać, zwykle w wykonaniu kogoś, kto już wiedział jak. Zweryfikowany walkthrough pokazuje, że zadanie zostało wykonane na określonej wersji, z wynikiem porównanym z dowodami pochodzącymi z samego produktu i z nieudanymi próbami, które nadal są widoczne.

Kto go weryfikuje?

Człowiek. Operator AI obsługuje produkt, a człowiek porównuje wynik z dowodami pochodzącymi z samego produktu i decyduje, czy nadaje się on do publikacji. Nic nie jest publikowane bez sprawdzenia.

Co się dzieje, gdy produkt się zmienia?

Każdy walkthrough ma zapisaną wersję, na której wykonano przebieg. Gdy dla tego produktu wychodzi nowe wydanie, zadania, których dotyczy lista zmian, są uruchamiane ponownie. Udany ponowny przebieg jest publikowany na nowo, a nieudany zostaje oznaczony wraz z logiem.

Czy wygenerowane wideo można zweryfikować?

Nie. Wygenerowane wideo nigdy nie było ograniczone tym, co robi oprogramowanie, więc nie ma go z czym porównać. Może być trafnym objaśnieniem faktów zweryfikowanych gdzie indziej, ale nie jest dowodem dotyczącym produktu.