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?

Garderoba teatralna – jak powstaje kostium?



Wpis sponsorowany

Na dobrą sztukę teatralną składa się wiele istotnych czynników. To nie tylko doskonale napisany scenariusz oraz bezbłędna gra aktorów (chociaż owszem, bez tych dwóch nie ma mowy o popularności spektaklu), ale również strona wizualna. Mniej istotne, jeżeli akcja sztuki została osadzona we współczesności, jednak w przypadku przedstawienia historycznego kwestie dotyczące scenografii, a zwłaszcza kostiumów, mogą wymagać ogromnej ilości czasu i pieniędzy. Kostium teatralny, który nosi bohater powstaje wieloetapowo, głównie dzięki poprawnie przeprowadzonym badaniom, a przede wszystkim płynnej współpracy kostiumografa z autorem, reżyserem, producentem oraz scenografem.

Czytaj dalej Garderoba teatralna – jak powstaje kostium?

Co powinna zawierać ulotka promocyjna?



Wpis sponsorowany

Dystrybucja ulotek to znany wszystkim sposób reklamowania firmy lub nowych produktów. W gąszczu różnych wizytówek, folderów i broszur trudno wyróżnić się z własnym projektem, chociaż nie jest to niemożliwe. Wystarczy orientować się w nowoczesnych metodach druku oraz dysponować kreatywnymi pomysłami. Ważne jest także zachowanie kilku zasad.

Czytaj dalej Co powinna zawierać ulotka promocyjna?