Każdy ma swoje dziwactwa. Ja na przykład jestem dziwny, bo piszę dokumentację. No dobra, dużo osób pisze i nie jest tak dziwna. Ja piszę, bo… to lubię!
Mam wrażenie, że to pewna część mnie, która lubi spisywać, aby lepiej rozumieć. Kilka lat temu znalazłem potwierdzenie tego w teście Gallupa - cecha/talent Input jest u mnie dość wysoko.

A dlaczego o tym dzisiaj piszę? Bo okazuje się, że słowo pisane jest jeszcze ważniejsze niż wcześniej.

Pisanie pozostanie

Są nadal ludzie, którzy spisują swoje przemyślenia i doświadczenia. Dzięki temu wciąż mamy mnóstwo książek i ciekawych publikacji.
Ja należę do tych, co lubią konkrety, a nie lanie wody i dlatego od jakiegoś czasu posiadam własną subskrypcję O’Reilly. Czytam skondensowaną wiedzę i karmię mój umysł, aby miał nad czym pracować.
Myślę coraz intensywniej nad napisaniem własnej książki, ale to melodia przyszłości 🤫.
Skoro czytasz ten newsletter, to też należysz do tych, co wciąż cenią sobie słowo pisane - możesz teraz poklepać się po ramieniu i pogratulować, bo czytanie jest coraz mniej popularne.

A jaki jest powód, że słowo pisane jest tak ważne? Oczywiście to AI, a dokładniej LLMy. Ktoś musi karmić modele kreatywnymi treściami, bo same nic nie wymyślą.
Doszło do tego, że twórcy modeli AI muszą wypłacać olbrzymie odszkodowania autorom książek. Najcenniejsza wiedza jest właśnie w książkach i najwidoczniej 1.5 tryliona dolarów to wciąż niewielka cena za wartość, jaką dały te treści modelom LLM firmy Anthropic.

Sam tekst w postaci kodu ma też olbrzymie znaczenie. Dlatego też jestem takim entuzjastą GitOps, który poruszałem dość szczegółowo w ostatnich odcinkach podcastu.
Jak masz wszystko w kodzie, to umożliwiasz agentom AI usprawnianie Twojej platformy. To dlatego, że podobnie jak w przypadku książek, LLMy bazują na tekście i potrafią go świetnie zrozumieć. A Ty wtedy skupiasz się na budowaniu mentalnych modeli (ktoś musi mieć wiedzę, aby wydawać polecenia i weryfikować halucynacje) zamiast wykonywać żmudne zadania.

A jak to się ma do mojego dziwactwa pisania dokumentacji? Pozwól, że wytłumaczę posługując się przykładem z jednego z moich projektów.

Duży projekt, jeszcze większe wyzwania

Wszystko działa pięknie podczas demo z tutoriali oraz też w małych startupach. Co innego, jak projekty są naprawdę w dużej skali.
Pewnie też to znasz. Duże środowiska to dużo rozwiązań, dużo klastrów, oddzielne zespoły rozproszone geograficznie, Jira, Confluence i mnóstwo procedur/approvali. W takim środowisku również uczestniczę, gdzie jest sporo rzeczy do zrobienia, bo też skala jest olbrzymia.
Od strony technicznej jest mniej więcej jasne, jak dowieźć projekt. Problemem jest brak informacji o szczegółach. Nie mogę ich tu oczywiście podać, ale z reguły kończy się to poszukiwaniem osób z wiedzą o danym obszarze. Przypomina mi to opisywany dawno temu przykład wiedzy plemiennej i jak widać temat jest wciąż aktualny.

Ja mam lekką awersję do spotkań, jeśli czuję, że tracę czas. One jednocześnie wysysają energię i przeszkadzają w dowożeniu wartości do projektu. Niestety, większość spotkań jest niepotrzebna (coś w stylu “This meeting should be an email”), a zamiast tego wystarczyłoby mieć dobrą dokumentację.

Nie zrozum mnie źle - dokumentacja jakaś jest. Jeśli jest napisana tak sobie, to i tak jest super, bo dzięki czatom z agentami AI da się jej całkiem nieźle użyć. Gorzej, jak jej nie ma lub nie odzwierciedla rzeczywistości (jest nieaktualna lub błędna).

Lepsze zastosowanie AI

Piękne są te posty o agentach AI i sam pracuję nad projektem, gdzie będą one współtworzyć platformę na podstawie GitOps. Ale co jeśli już teraz możemy rozwiązać bieżące problemy o wiele łatwiej dzięki AI?

Nie każdy lubi i chce pisać dokumentację. Ok, to niech napisze ją AI. Dajmy mu kilka punktów lub jeszcze lepiej - dostęp do rozwiązania i niech go sprawnie opisze. Albo nawet możemy ominąć krok dokumentacji i od razu dać dostęp do źródeł wiedzy, które pomogą odnaleźć istotne dla nas informacje.
To ostatnie obarczone jest pewnym ryzykiem (bezpieczeństwo) i dlatego utworzenie snapshota informacji w postaci dokumentacji jest wystarczająco dobre.

Ale jest kolejne wyzwanie. Dokumentacja potrafi być porozrzucana po różnych stronach w różnych hierarchiach. To nie problem, jeśli nie musimy jej czytać bezpośrednio, tylko czatować z AI. W końcu chodzi nam o zrozumienie lub znalezienie odpowiedzi na nurtujące nas pytanie.
Bez zbędnych spotkań, asynchronicznie, sprawnie i z większą satysfakcją. To zmienia naprawdę wiele i jest nisko wiszącym owocem.

Aby użyć AI jako force-multiplier do budowania mentalnych modeli, potrzebujemy pracować nad zrozumieniem systemu, z którym pracujemy. I do tego AI nadaje się wyśmienicie.
Piszmy zatem dokumentację. Lub lepiej - niech AI pisze ją za nas.

🔥 KCD Warsaw 2025 już za tydzień

Przypominam, że już za tydzień jest konferencja, którą współorganizuję i na której będę ja oraz inni ludzie z branży. Warto się spotkać!

To pierwsza taka konferencja w Polsce. Jest to impreza non-profit pod oficjalnym patronatem CNCF i odbędzie się 9 października 2025 w Warszawie.
Mamy fajne miejsce, interesujące prezentacje (wybór był ciężki) i ogromne zainteresowanie ludzi. Ja wraz z innymi wolontariuszami wkładamy mnóstwo wysiłku, aby było to wyjątkowe wydarzenie. Jeszcze sporo pracy przed nami, ale już teraz możesz się zarejestrować ze specjalną 20% zniżką.

🎟️ Użyj specjalnego kodu przy rejestracji:

CLOUDOWSKI20

Liczba biletów jest ograniczona przez samo miejsce i fakt, że impreza nie ma celu komercyjnego - liczy się wartość, jaką przyniesie naszej społeczności. Samo miejsce jest bardzo fajne, bo w samym centrum Warszawy, w nowoczesnym Varso Tower, tuż obok Dworca Centralnego.

A dlaczego warto wpaść?
Oto 3️⃣ najważniejsze powody według mnie:

1. Spotkanie innych entuzjastów - jako introwertyk, ale jednocześnie pasjonat bardzo doceniam spotkania z innymi ekspertami i ciekawe dyskusje
2. Prezentacje na żywo - można oglądać na YouTube, ale na żywo jest zdecydowanie lepiej - to jak taki koncert tylko dla geeków
3. Fajny klimat - sporo się napracowaliśmy nad budową fajnego klimatu imprezy dla profesjonalistów z branży bez zadęcia i ciągłej sprzedaży

👉 Zarejestruj się już teraz na stronie wydarzenia i do zobaczenia już za tydzień!