Swagger – czyli jak pisać dokumentację API?



Tworzenie REST API. W dobie szerokiej popularności frontendowych frameworków to chyba najpopularniejsze zadanie backendowca. Dotyczy ono jednak całego zespołu, a w produkcji może okazać się zaskakująco… problematyczne.

Wyobraźmy sobie nowy projekt. Zespół jest kompletny. Grafik, frontendowiec, backendowiec a nawet SCRUM Master. Wszystko wygląda pięknie i zapowiada się dobrze. Wtem! Klient wpada na genialny pomysł – zmieńmy nieco architekturę: od teraz to, co zostało już zrobione, ma działać w inny sposób. Aha, mamy na to 3 dni i musimy sie wyrobić! Brzmi znajomo? Cóż zdarza się.

I tu pojawia się Swagger – cały na biało. Kompletny framework do projektowania, prototypowania i dokumentowania API. Za pomocą prostego pliku yaml, lub json możesz znacząco przyśpieszyć i zwiększyć jakość swojej pracy. Zapisanie endpointu ogranicza się więc do zapisania kilku linijek kodu. Podajemy adres, wejściowe dane, możliwe odpowiedzi z serwera i… dokumentacja gotowa. Klika kliknięć więcej i otrzymujemy działający endpoint, zawierający zmockowane dane.

Tak oto frontend może działać bez ostatecznego rozwiązania, a backend bez presji tworzyć wysokiej jakości kod. Na koniec klient nie tylko dostaje to czego chciał, ale też w pełni profesjonalną dokumentację, która… napisała się sama!

Brzmi dobrze? To przejdźmy do konkretów i napiszmy swój pierwszy projekt w Swaggerze.

Czytaj dalej Swagger – czyli jak pisać dokumentację API?

Test driven development w marketingu



To, co odróżnia prawdziwego programistę od klepacza kodu to między innymi inny rodzaj myślenia. Klepacz klepie to co umie, a programista projektuje, planuje, testuje i programuje. Prawdziwy programista myśli jak architekt – wykorzystuje wzorce projektowe, określone metodyki i standardy pracy. Od tych najlepszych, można się bardzo wiele nauczyć, ale czy programiści byli by w stanie nauczyć nas czegoś o marketingu? Oczywiście!

W programowaniu znana jest technika Test Driven Development. TDD polega na tym, że programista najpierw pisze test, a dopiero później realne rozwiązanie o które chodziło mu od początku. Dzięki temu podejściu aplikacje są o wiele lepszej jakości. Pomyślałem sobie – a co jeśli tą metodę wykorzystali byśmy w podejmowaniu decyzji w biznesie?

Aby pokazać Ci jak działa TDD w praktyce, wykorzystamy do tego konkretny przykład. Załóżmy, że ktoś zaprosił Ciebie na spotkanie grupy, która pomoże Ci sprzedawać więcej produktów. W moim przypadku było tak z BNI Polska. Wiedziałem, że koszt dołączenia do tej społeczności wynosi 2000zł rocznie, spotkania organizowane są o 6:30 rano a obecność na nich jest obowiązkowa. Czy warto w to zainwestować? Chodzi tu nie tylko o pieniądze ale również czas i kontakty. Żeby mądrze odpowiedzieć na to pytanie, wykorzystamy technikę Test Driven Development.

Czytaj dalej Test driven development w marketingu

Jak nazwać firmę, czyli sposób na naming.



Gdy zaczynasz budować nową firmę, startup czy markę, przychodzi moment w którym zaczynasz szukać dla niej nazwy. Jej wymyślenie wcale nie jest łatwe. Warto jednak poświęcić trochę czasu na dobór dobrej nazwy. W końcu to ona jest jednym z najważniejszych elementów marki, na swoją nazwę będziesz pracował. Dzisiejszy wpis będzie więc o namingu, czyli o tym jak nazwać firmę.

Nazwa jest najważniejszym elementem werbalnym marki. Jeśli ktoś będzie chciał powiedzieć o Twoim produkcie drugiej osobie, z pewnością wykorzysta właśnie nazwę. Gorzej, jeśli Twoja nazwa zawiera jakiegoś rodzaju wpadki. Trudna do wypowiedzenia i zapamiętania może sprawić, że klient już do Ciebie nie wróci. Nie ma niczego złego w nazwach obcojęzycznych, ale sprawdź, czy Twoja nazwa nie jest dwuznaczna. Pamiętasz żarówki Osram? Niemiecka firma produkująca żarówki nie sprawdziła, co na Polskim rynku oznacza to słowo i wyszło co wyszło, ale przyznać trzeba, została zapamiętana.

Czytaj dalej Jak nazwać firmę, czyli sposób na naming.