Tutoriale¶

Obowiązki nauczyciela¶

Lekcja to rodzaj umowy między nauczycielem a uczniem, w której niemal cała odpowiedzialność spoczywa na nauczycielu. Nauczyciel odpowiada za to, czego uczeń ma się nauczyć, co uczeń będzie robił, aby się tego nauczyć, oraz za sukces ucznia. Tymczasem jedynym obowiązkiem ucznia w tej umowie jest bycie uważnym i jak najdokładniejsze podążanie za wskazówkami nauczyciela. Na uczniu nie spoczywa obowiązek nauki, zrozumienia czy zapamiętania.

Jednocześnie ćwiczenie, które stawiasz przed uczniami, musi być:

• znaczące - uczeń musi mieć poczucie osiągnięcia

• udane - uczeń musi być w stanie je ukończyć

• logiczne - ścieżka, którą podąża uczeń, musi mieć sens

• w pełni użyteczne - uczeń musi zetknąć się ze wszystkimi działaniami, pojęciami i narzędziami, które musi poznać

Problem samouczków¶

Samouczki rzadko są dobrze wykonane, częściowo dlatego, że są naprawdę trudne do wykonania, a częściowo dlatego, że nie są dobrze rozumiane. W oprogramowaniu wiele produktów nie ma dobrych samouczków lub nie ma ich wcale; samouczki są często mylone z poradnikami krok po kroku.

W idealnej lekcji nauczyciel jest obecny i wchodzi w interakcje z uczniem, odpowiadając na niego, poprawiając jego błędy i sprawdzając jego naukę. W dokumentacji żadna z tych rzeczy nie jest możliwa.

Już samo złożenie doświadczenia nauki, które spełnia wszystkie opisane powyżej standardy, jest trudne; w wielu kontekstach sam produkt szybko ewoluuje, co oznacza, że cała ta praca musi być wykonana ponownie, aby zapewnić, że samouczek nadal spełnia swoje wymagane funkcje.

Często również okazuje się, że żadna inna część twojej dokumentacji nie podlega rewizjom w taki sposób, jak twoje samouczki. Gdzie indziej w dokumentacji zmiany i ulepszenia można zazwyczaj wprowadzać dyskretnie; w samouczkach, gdzie cała ścieżka nauki od początku do końca musi mieć sens, często kaskadują przez całą historię.

Ostatecznie samouczki zawierają dodatkową komplikację rozróżnienia między tym, czego należy się nauczyć, a tym, co należy zrobić. Twórca samouczka musi nie tylko dobrze rozumieć, czego użytkownik musi się nauczyć i kiedy, ale także opracować znaczącą ścieżkę nauki, która w jakiś sposób dostarcza to wszystko.

Pokaż uczącemu się, dokąd będą zmierzać¶

Ważne jest, aby od samego początku pozwolić uczącemu się uformować sobie ideę, co osiągną. Oprócz pomocy w ustawieniu oczekiwań, pozwala im to zobaczyć siebie, jak budują ku ukończonemu celowi, pracując nad tym.

Dostarczenie obrazu, którego uczący się potrzebuje w samouczku, może być tak proste, jak poinformowanie ich na początku: W tym samouczku stworzymy i wdrożymy skalowalną aplikację webową. Po drodze spotkamy się z narzędziami i usługami do konteneryzacji.

Nie jest to to samo, co powiedzenie: W tym samouczku nauczysz się... - co jest zuchwałe i bardzo zły wzorzec.

Dostarczaj widoczne wyniki wcześnie i często¶

Twój uczący się prawdopodobnie wykonuje nowe i dziwne rzeczy, których nie do końca rozumie. Zrozumienie pochodzi z możliwości nawiązywania połączeń między przyczynami a skutkami, więc pozwól im zobaczyć wyniki i nawiązywać te połączenia szybko i wielokrotnie. Każdy z tych wyników powinien być czymś, co użytkownik może zobaczyć jako znaczące.

Każdy krok, który podąża uczący się, powinien produkować zrozumiały wynik, choćby mały.

Utrzymuj narrację oczekiwań¶

Na każdym kroku samouczka użytkownik doświadcza momentu niepokoju: czy ta akcja wyprodukuje poprawny wynik? Częścią pracy udanego samouczka jest ciągłe dostarczanie uczącemu się informacji zwrotnej, że rzeczywiście są na właściwej ścieżce.

Utrzymuj narrację oczekiwań: Zauważysz, że...; Po kilku chwilach serwer odpowiada.... Pokaż użytkownikowi rzeczywisty przykładowy output, a nawet dokładnie oczekiwany output.

Jeśli z góry wiesz, jakie są prawdopodobne oznaki pójścia źle, rozważ ich oznaczenie: Jeśli wynik nie pokaże się ..., prawdopodobnie zapomniałeś o ....

Pomocne jest przygotowanie użytkownika na potencjalnie zaskakujące akcje: Polecenie prawdopodobnie zwróci kilkaset linii logów w twoim terminalu.

Wskaż, na co uczący się powinien zwrócić uwagę¶

Nauka wymaga refleksji. Dzieje się to na wielu poziomach i głębokościach, ale jednym z pierwszych jest, gdy uczący się obserwuje znaki w swoim otoczeniu. W lekcji uczący się jest zazwyczaj zbyt skupiony na tym, co robi, aby je zauważyć, chyba że zostanie do tego nakierowany przez nauczyciela.

Twoim zadaniem jako nauczyciela jest zamykanie pętli nauki przez wskazywanie rzeczy, mimochodem, gdy lekcja posuwa się naprzód. Może to być tak proste, jak wskazanie, jak zmienia się prompt wiersza poleceń, na przykład.

Obserwacja jest aktywną częścią rzemiosła, a nie tylko bierną. Oznacza to zwracanie uwagi na otoczenie, co samo w sobie jest umiejętnością. Często jest to zaniedbywane.

Celuj w poczucie działania¶

We wszelkich umiejętnościach lub rzemiośle, doświadczony praktyk doświadcza poczucia działania, zintegrowanego celu, akcji, myślenia i wyniku.

W miarę rozwoju umiejętności, płynie ona w pewnym rytmie i staje się rodzajem przyjemności. Jest to przyjemność chodzenia, na przykład.

Umiejętność uczącego się zależy od tego, czy odkryją to poczucie, i czy stanie się ono przyjemnością.

Twoim wyzwaniem jako twórcy samouczka jest zapewnienie, że jego zadania łączą cel i akcję, tak że stają się kolebką dla tego poczucia.

Zachęcaj i pozwalaj na powtarzanie¶

Uczący się będą wracać i powtarzać ćwiczenie, które daje im sukces, dla przyjemności, jaką znajdują w uzyskiwaniu oczekiwanego wyniku. Robiąc to, potwierdzają sobie, że potrafią to zrobić, i że to działa.

Powtarzanie jest kluczem do ustanowienia poczucia działania; bycie u siebie z tym poczuciem jest podstawową warstwą nauki.

W twoim samouczku, spróbuj uczynić możliwym powtórzenie określonego kroku i wyniku. Może to być trudne, na przykład w operacjach, które nie są odwracalne (co utrudnia powrót do poprzedniego kroku) - ale dąż do tego, gdzie tylko możesz. Obserwując użytkownika podążającego za samouczkiem, często możesz być zaskoczony, widząc, jak często wybierają powtórzenie kroku. Robią to tylko po to, aby zobaczyć, że to samo rzeczywiście dzieje się ponownie.

Bezwzględnie minimalizuj wyjaśnienia¶

Samouczek nie jest miejscem na wyjaśnienia. W samouczku użytkownik skupia się na prawidłowym podążaniu za twoimi instrukcjami i uzyskiwaniu oczekiwanych wyników. Później, gdy będą gotowi, będą szukać wyjaśnień, ale w tej chwili są skoncentrowani na działaniu. Wyjaśnienie odwraca ich uwagę od tego i blokuje ich naukę.

Na przykład, wystarczy powiedzieć coś w stylu: Używamy HTTPS, ponieważ jest bardziej bezpieczne. Jest miejsce na rozszerzoną dyskusję i wyjaśnienie HTTPS, ale nie teraz. Zamiast tego, podaj link lub odniesienie do tego wyjaśnienia, tak aby było dostępne, ale nie przeszkadzało.

Wyjaśnienie jest jedną z najtrudniejszych pokus, którym nauczyciel musi się oprzeć; nawet doświadczeni nauczyciele mają trudności z zaakceptowaniem, że nauka uczniów nie zależy od wyjaśnień. Jest to całkowicie naturalne. Gdy już coś zrozumieliśmy, polegamy na mocy abstrakcji, aby to sobie ująć - i w ten sposób chcemy to ująć dla innych. Zrozumienie oznacza uchwycenie ogólnych idei, a abstrakcja jest logiczną formą zrozumienia - ale nie tego potrzebujemy w samouczku, i nie tak działa skuteczna nauka lub nauczanie.

Trzeba to zobaczyć na własne oczy, aby zobaczyć, jak skupiona uwaga ucznia rozpływa się w powietrzu, gdy dobrze intencjonowane wyjaśnienie nauczyciela przerywa magiczne zaklęcie nauki.

... i skup się na konkrecie¶

W sytuacji nauki, twój uczeń jest w chwili, chwili złożonej z konkretnych rzeczy. Jesteś odpowiedzialny za ustawienie i utrzymanie przepływu ucznia, od jednego konkretnego działania i wyniku do kolejnego.

Skup się na tym problemie, tym działaniu, tym wyniku, w taki sposób, że prowadzisz uczącego się od kroku do konkretnego kroku.

Może się wydawać, że utrzymując skupienie na konkrecie i szczególnym, odmawiasz uczniowi możliwości zobaczenia lub uchwycenia większych ogólnych wzorców, ale jest odwrotnie. Jedna rzecz, którą nasze umysły robią spektakularnie dobrze, to dostrzeganie ogólnych wzorców z konkretnych przykładów. Cała nauka przebiega w jednym kierunku: od konkretnego i szczegółowego, ku ogólnemu i abstrakcyjnemu. To ostatnie wyłoni się z tego pierwszego.

Ignoruj opcje i alternatywy¶

Twoim zadaniem jest poprowadzenie uczącego się do udanego zakończenia. Może być wiele interesujących odgałęzień po drodze (różne opcje dla polecenia, którego używasz, różne sposoby korzystania z API, różne podejścia do zadania, które opisujesz) - ignoruj je. Twoje wskazówki muszą pozostać skupione na tym, co jest wymagane, aby osiągnąć zakończenie, a wszystko inne można zostawić na inną okazję.

Robiąc to, pomagasz utrzymać twój samouczek krótszym i bardziej zwięzłym, i oszczędzasz zarówno tobie, jak i czytelnikowi konieczności wykonywania dodatkowej pracy umysłowej.

Dąż do doskonałej niezawodności¶

Wszystkie powyższe są ogólnymi zasadami pedagogiki, ale na twórcy samouczka spoczywa szczególne brzemię.

Samouczek musi budzić zaufanie. Zaufanie można budować tylko warstwa po warstwie, i łatwo je zachwiać. Na każdym etapie, gdy prosisz ucznia o zrobienie czegoś, muszą oni widzieć obiecany przez ciebie wynik. Uczący się, który podąża za twoimi instrukcjami i nie otrzymuje oczekiwanych wyników, szybko straci zaufanie, do samouczka, tutora i siebie samego.

Nauczyciel, który jest z uczniem, może go uratować, gdy coś pójdzie nie tak. W samouczku nie możesz tego zrobić. Twój samouczek powinien być tak dobrze skonstruowany, że rzeczy nie mogą pójść źle, że twój samouczek działa dla każdego użytkownika, za każdym razem.

Tworzenie niezawodnego doświadczenia jest trudną pracą, ale do tego musisz dążyć, tworząc samouczek.

Twój samouczek będzie miał wady i luki, niezależnie od tego, jak starannie zostanie napisany. Nie odkryjesz ich wszystkich samodzielnie, będziesz musiał polegać na użytkownikach, aby odkryli je za ciebie. Jedynym sposobem, aby dowiedzieć się, czym one są, jest sprawdzenie, co rzeczywiście dzieje się, gdy użytkownicy wykonują samouczek, poprzez rozległe testowanie i obserwację.