Dokumenty
Jak tworzymy treści
Wszystko, co czytasz na szron.tech, napisał jeden z nas dwóch i wynika z projektów, które prowadziliśmy. AI pomaga nam w pracy nad tekstem i grafiką. Tutaj opisujemy, gdzie dokładnie i na jakich zasadach.
Ostatnia aktualizacja:
1. Kto pisze
Teksty na stronie piszą Tomek Wojciechowski i Maciej Stopa. Pod każdym wpisem na blogu stoi nazwisko autora z linkiem do jego profilu. Nie publikujemy tekstów gościnnych, nie kupujemy artykułów i nie podpisujemy niczego nazwą firmy ani narzędzia.
Piszemy o tym, co robimy w pracy: wdrożeniach AI w zespołach programistycznych, Claude Code, systemach embedded i modernizacji starych systemów. Liczby w case studies pochodzą z projektów, które prowadziliśmy sami. Gdy klient nie zgodził się na publikację pełnych danych, piszemy to przy opisie, a referencje udostępniamy po podpisaniu NDA.
2. Do czego używamy AI
Pracujemy z Claude Code na co dzień, także przy tej stronie. Model pomaga nam w trzech rzeczach:
- redaguje nasze szkice: skraca, porządkuje składnię, wyłapuje powtórzenia i sformułowania, które brzmią jak przetłumaczone z angielskiego;
- sprawdza spójność: czy liczby i nazwy zgadzają się między stronami, czy linki prowadzą tam, gdzie trzeba;
- przygotowuje warianty nagłówków i opisów, z których wybieramy jeden albo piszemy własny.
Nie publikujemy tekstu, którego autor nie przeczytał w całości. Każdy fakt, który da się sprawdzić, sprawdzamy ręcznie: wersje narzędzi i komendy w dokumentacji producenta, ceny w cennikach, daty i cytaty w źródłach, do których linkujemy. Dotyczy to też tytułów, opisów meta i opisów alternatywnych obrazów.
3. Materiały szkoleniowe w Akademii
Strony Akademii opisują narzędzia, które zmieniają się co kilka tygodni. Raz w tygodniu agent porównuje podane tam fakty z aktualną dokumentacją producentów. Zmiana trafia na stronę tylko wtedy, gdy ma konkretne źródło, a raport z każdej zmiany dostaje Tomek. Fakty, których nie dało się potwierdzić, zostają w raporcie do ręcznego sprawdzenia, nie na stronie.
Napis „Ostatnia aktualizacja” pod nagłówkiem strony zmienia się tylko wtedy, gdy zmieniła się treść. Nie odświeżamy dat dla samego wyglądu świeżości.
4. Zdjęcia i grafiki
Większość ilustracji na stronie powstała z pomocą generatora obrazów na podstawie naszych opisów. Dotyczy to także części scen z naszym udziałem (na przykład tych, gdzie jesteśmy razem z Maciejem): wygenerowaliśmy je na podstawie własnych zdjęć, bo wolimy to niż zdjęcia stockowe obcych ludzi, i stopniowo zastępujemy je prawdziwymi fotografiami. Każdą taką grafikę oznaczamy w metadanych pliku standardem IPTC (DigitalSourceType: trainedAlgorithmicMedia), tak jak wymaga tego m.in. Google.
Prawdziwe fotografie i zrzuty ekranu nie mają tego znacznika. Przy obróbce fotografii zachowujemy dostępne oryginalne metadane aparatu. Są nimi portrety Tomka na stronach O nas, Kontakt i Umów rozmowę, zdjęcia z warsztatów ARM (z rozmytymi twarzami uczestników) i widoki aplikacji DevLens. Takie zdjęcia obrabiamy tylko klasycznie: kadr, ekspozycja, rozmiar, rozmycie twarzy.
Jest jeden wyjątek. Na zdjęciach z warsztatów prowadzonych przez Tomka przed założeniem SZRON (Akademia, Metoda, Coaching Sprint, Warsztat embedded, Transformacja AI dla programistów) generator zamienił twarze uczestników na fikcyjne, żeby chronić ich prywatność. Sala, ekrany, sprzęt i Tomek są prawdziwi. Te zdjęcia mają podpis i znacznik IPTC compositeWithTrainedAlgorithmicMedia.
5. Opinie i cytaty
Cytujemy tylko wypowiedzi, które padły. Przy cytatach z publikacji i wystąpień podajemy źródło. Przy opiniach klientów podajemy imię, nazwisko, stanowisko i firmę, a jeśli umowa o poufności na to nie pozwala, zaznaczamy to wprost i udostępniamy kontakt referencyjny na życzenie.
6. Błędy
Jeśli znajdziesz na stronie nieaktualny fakt, złą komendę albo literówkę, napisz na tw@szron.tech. Poprawiamy w ciągu kilku dni i zmieniamy wtedy datę aktualizacji na stronie.
7. Kto odpowiada za stronę
Wydawcą serwisu jest Szron Tomasz Wojciechowski (jednoosobowa działalność gospodarcza, NIP 8133318863, REGON 541221883), ul. Legionistów 12/1/B, 35-317 Rzeszów. Kontakt: tw@szron.tech, +48 505 091 200. Pozostałe dokumenty: polityka prywatności i warunki korzystania.