Pomorskie LIVE — dokumentacja

Tablice odjazdów na żywo dla Gdańska, Gdyni i okolic. Ta dokumentacja wyjaśnia rzeczy, które nie mieszczą się w dymku przy odjeździe: skąd biorą się dane, dlaczego czasem widać dziwne liczby i co dokładnie znaczą oznaczenia na tablicy.

Czym to jest

Serwis pokazuje odjazdy z przystanków ZTM Gdańsk i ZKM Gdynia, korzystając z otwartych danych obu miast. Nie jest to serwis żadnego z operatorów ani przewoźnika — to niezależna nakładka na publicznie udostępniane API.

Aplikacja działa w przeglądarce, także po zainstalowaniu jako aplikacja na telefonie. Ulubione tablice i ustawienia zostają na urządzeniu i nie są nigdzie wysyłane.

Zasady, według których jest budowana

Zero zależności. Cały serwis — serwer, aplikacja i narzędzia — korzysta wyłącznie z tego, co jest wbudowane w przeglądarkę i w Node. Nie ma package.json ani żadnej biblioteki z zewnątrz. Ta dokumentacja też jest generowana własnym konwerterem.

Informacja dostępna, nie narzucona. Tablica pokazuje to, po co się na nią patrzy: kiedy przyjedzie autobus. Wyjaśnienia są pod dymkiem, statystyki na osobnym ekranie — dla tych, którzy ich szukają.

Liczby są mierzone, nie szacowane. Każda liczba w tej dokumentacji i w statystykach pochodzi z pomiaru na prawdziwych danych. Tam, gdzie czegoś nie wiemy, jest to napisane wprost.

Co jest w środku

480 testów w 44 plikach, uruchamianych wbudowanym node --test.

Strony