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, za to zachowują oryginalne metadane aparatu (datę i model, bez lokalizacji). Są nimi portrety Tomka na stronach O nas, Kontakt i Umów rozmowę, zdjęcia z warsztatów prowadzonych przez Tomka (także tych sprzed założenia SZRON, co zaznaczamy w opisie), zdjęcia z warsztatów ARM i widoki aplikacji DevLens. Zdjęcia obrabiamy tylko klasycznie: kadr, ekspozycja, rozmiar. Nie zmieniamy ich generatorem.

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.