Épisodes

  • #79 Tech Writer koduje z AI, czyli latanie z drugim pilotem w praktyce
    Jun 23 2025

    Od niedawna mamy możliwość korzystania w pracy z pomocy sztucznej inteligencji, a konkretnie GitHub Copilota.

    Rozmawiamy o tym jak działa to narzędzie, jakie ma możliwości i w jaki sposób zmienia naszą pracę. Omawiamy konkretne przykłady zastosowania drugiego pilota w kodowaniu i tworzeniu dokumentacji i staramy się ocenić czy w ogólnym rozrachunku jest on dla nas pomocą, utrudnieniem czy zagrożeniem.

    Informacje dodatkowe:

    • GitHub Copilot: https://github.com/features/copilot
    • "Agentic AI", Wikipedia: https://en.wikipedia.org/wiki/Agentic_AI
    • "Darwin Information Typing Architecture", Wikipedia: https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
    • "AI Changes Everything", Armin Ronacher: https://lucumr.pocoo.org/2025/6/4/changes/
    • "My AI Skeptic Friends Are All Nuts", Thomas Ptacek: https://fly.io/blog/youre-all-nuts/
    • "Agent AI - kopilot dla tech writera", Paweł Kowaluk: https://techwriter.pl/copilot-dla-tech-writera
    • "#57 Tech Writer zostaje Prompt Engineerem, czyli nowa potencjalna ścieżka kariery dla technoskryby", Tech Writer Koduje: https://techwriterkoduje.pl/blog/2023/8/28/57
    Voir plus Voir moins
    40 min
  • #78 Tech Writer buduje społeczność, czyli Content Bytes od kuchni
    May 16 2025

    Co mają ze sobą wspólnego wędkarze i technoskryby? I nie chodzi o nam o słowo "ryby". To, że mogą stworzyć społeczność, która będzie się spotykać, wymieniać doświadczeniami i wspierać w trudnych momentach.

    Ale jak sprawić, żeby taka społeczność powstała? Odpowiedź wydaje się prosta - dać ludziom przestrzeń do spotkań, zrobić prezentację i nakarmić. Jednak w rzeczywistości wymaga to zdecydowanie więcej wysiłku.

    Rozmawiamy z Edytą Rakowską i Basią Czyż z Content Bytes o cieniach i blaskach organizowania meetupów dla specjalistów zajmujących się szeroko pojętą treścią, o tym co je motywuje do działania, dlaczego warto dołączyć jako uczestnik i prelegent oraz o ich planach na przyszłość.

    Informacje dodatkowe:

    • Content Bytes: https://contentbytes.pl/
    • CAKE Conf: https://cakeconf.contentbytes.pl/
    • Content Bytes #04 - "Let's talk language": https://contentbytes.pl/events/2025/4
    • Michał Olender, LinkedIn: https://www.linkedin.com/in/michal-olender/
    • Paweł Chłodnicki, LinkedIn: https://www.linkedin.com/in/pawelchlodnicki/
    • Tomasz Prus, LinkedIn: https://www.linkedin.com/in/tomasz-prus-4b09b01a/
    • Slack: https://slack.com/
    • Linear: https://linear.app/
    Voir plus Voir moins
    44 min
  • #77 Tech Writer ogarnia gita, czyli moc ukryta w znajomości podstaw
    Apr 23 2025

    Mówi się, że zanim zaczniemy biegać musimy nauczyć się chodzić. W tej mądrości ludowej kryje się wiele prawdy, którą można zastosować do nauki jakiegokolwiek zagadnienia, np. systemu kontroli wersji Git.

    Powierzchowna znajomość Gita i jego najpopularniejszych komend może nam zapewnić spokój na całkiem długi czas, ale w pewnym momencie zaczniemy dostrzegać trudności w radzeniu sobie z pewnymi sytuacjami. Niechlujne wpisy w historii zmian na pewno utrudnią nam ustalenie kto, kiedy i dlaczego coś zmienił, a brak znajomości podstawowych zagadnień i mechaniki Gita spowoduje, że nieraz poczujemy się zagubieni i bezradni.

    Rozmawiamy o tym jak zadbać o to, żeby nasza historia zmian była jasna i przejrzysta, a przez to przydatna i z jakiego zakresu uzupełnić wiedzę teoretyczną o Gicie, a także dzielimy się wskazówkami na temat przydatnych ustawień i komend.

    Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

    Informacje dodatkowe:

    • Git: https://git-scm.com/
    • "How to Write a Git Commit Message", cbeams: https://cbea.ms/git-commit/
    • "Git turns 20: A Q&A with Linus Torvalds", GitHub: https://github.blog/open-source/git/git-turns-20-a-qa-with-linus-torvalds/
    • "How did Git get its name?", Initial Commit: https://initialcommit.com/blog/How-Did-Git-Get-Its-Name
    • Conventional Commits: https://www.conventionalcommits.org/en/v1.0.0/
    • "Darwin Information Typing Architecture (DITA)", Wikipedia: https://pl.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
    • "Git Squash Commits: A Guide With Examples", DataCamp: https://www.datacamp.com/tutorial/git-squash-commits
    • "How to Create and Push an Empty Commit in Git", Tower FAQ: https://www.git-tower.com/learn/git/faq/git-empty-commit
    • "8.1 Customizing Git - Git Configuration", Git: https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration
    Voir plus Voir moins
    50 min
  • #76 Tech Writer staje się bardziej otwarty, czyli jak i po co wejść w open source
    Mar 28 2025

    Naszym zdaniem otwarty umysł to bardzo przydatna cecha. Idea otwartości w połączeniu z działaniem na rzecz wspólnego dobra to nic innego jak "open source".

    Projekty z obszaru wolnego i otwartego oprogramowania przynoszą wielu organizacjom i jednostkom niebagatelne korzyści. Pomimo tego, że większość z nas jest świadoma ich ogromnej wartości, zazwyczaj borykają się one z problemem braku rąk do pracy. Cierpi na tym nie tylko kod, ale też dokumentacja. I to bardzo.

    Z naszym gościem, Łukaszem Górnickim, staramy się Wam przybliżyć wyjątkowy świat "open source". Rozmawiamy o tym czym jest wolne i otwarte oprogramowanie, jakimi prawami się rządzi i jak wygląda praca w projektach "open source", dlaczego warto do nich dołączyć i jak to zrobić. A to wszystko z perpektywy Tech Writera.

    Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

    Informacje dodatkowe:

    • "Open-source software", Wikipedia: https://en.wikipedia.org/wiki/Open-source_software
    • "FLOSS and FOSS", Richard Stallman: https://www.gnu.org/philosophy/floss-and-foss.en.html
    • Open Source Initiative (OSI): https://opensource.org/
    • Google Season of Docs: https://developers.google.com/season-of-docs
    • Outreachy: https://www.outreachy.org/
    • Kubernetes: https://kubernetes.io/
    • Postman: https://www.postman.com/
    • AsyncAPI: https://www.asyncapi.com/en
    • "VMware Sued over Alleged Open Source License Violation in Linux", Sean Michael Kerner: https://www.datamation.com/open-source/vmware-sued-over-alleged-open-source-license-violation-in-linux/
    • Git: https://git-scm.com/
    • GitHub (vel "Instagram dla deweloperów"): https://github.com/
    • Techwriter.pl: https://techwriter.pl/
    • Open Source Program Office (OSPO): https://github.com/todogroup/ospodefinition.org
    • OSPOs for good 2024 conference report: https://www.un.org/digital-emerging-technologies/sites/www.un.org.techenvoy/files/OPSOs_for_Good_2024_Conference_Report.pdf
    • "The European Organization for Nuclear Research (CERN) ": https://en.wikipedia.org/wiki/CERN
    • OpenForum Europe (OFE): https://openforumeurope.org/about-ofe/
    • Capital Series Poland: https://openforumeurope.org/event/capital-series-poland/
    • Bielik LLM: https://bielik.ai/
    • Brain Fart Services: https://www.brainfart.dev/
    Voir plus Voir moins
    1 h et 16 min
  • #75 Tech Writer wprowadza porządek, czyli po co nam structured writing
    Mar 3 2025

    W komunikacji technicznej (i nie tylko) występuje zjawisko ustrukturyzowanego tworzenia treści, czyli "structured writing" albo jak kto woli "structured authoring". Cała idea sprowadza się do stworzenia zasad, które są potem stosowane w trakcie pisania. Poprzez narzucenie takich ściśle określonych reguł jesteśmy w stanie dostarczać treść, która jest lepszej jakości i którą nasi odbiorcy są w stanie łatwiej i szybciej konsumować.

    "Structured writing" to złożone zagadnienie. Mnogość zalet przeplata się tutaj z równie dużą liczbą wyzwań.

    Rozmawiamy o tym czym jest ustrukturyzowane tworzenie treści, co nam daje, w czym nam pomaga a w czym przeszkadza oraz jakich standardów i narzędzi możemy użyć do jego wdrożenia w organizacji.

    Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

    Informacje dodatkowe:

    • "Structured writing", Wikipedia: https://en.wikipedia.org/wiki/Structured_writing
    • "Structured authoring in technical documentation: an overview", Author-it blog: https://www.author-it.com/blog/structured-authoring-in-technical-documentation/
    • "What is Structured Writing?", Mark Baker: https://techwhirl.com/what-is-structured-writing/
    • "Topic-based authoring", Wikipedia: https://en.wikipedia.org/wiki/Topic-based_authoring
    • "Darwin Information Typing Architecture", Wikipedia (DITA): https://pl.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
    • "Markdown", Wikipedia: https://pl.wikipedia.org/wiki/Markdown
    • "The path to structured content with Markdown", Niklas Begley: https://www.doctave.com/blog/path-to-structured-markdown
    • Semantic Authoring Markdown (sam): https://github.com/mbakeranalecta/sam
    • Semantic Markdown: https://hackmd.io/@sparna/semantic-markdown-draft#What-is-Semantic-Markdown
    • Markdoc: https://markdoc.dev/
    • MDX: https://mdxjs.com/
    • Lightweight DITA: https://docs.oasis-open.org/dita/LwDITA/v1.0/cnprd01/LwDITA-v1.0-cnprd01.html
    • HyperText Markup Language (HTML): https://developer.mozilla.org/en-US/docs/Web/HTML
    Voir plus Voir moins
    56 min
  • #74 Tech Writer poszukuje clou swojej pracy, czyli za co nam płacą
    Jan 29 2025

    Kiedy Tech Writer nie koduje, zaczyna rozważać nad swoją egzystencją, a dokładniej nad tym jaką unikalną wartość wnosi jego praca.

    Nie jest łatwo odpowiedzieć na pytanie jakie jest clou pracy Tech Writera, dlatego o pomoc poprosiliśmy Aleksandrę Wieczorek-Konieczko, która ma kilka lat różnorodnego doświadczenia w branży komunikacji technicznej i sporo przemyśleń na ten temat. Wspólnie zastanawiamy się za co nam tak naprawdę płacą i dlaczego naszej pracy nie może wykonywać ktoś inny z równie dobrym skutkiem.

    Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

    Informacje dodatkowe:

    • Passo uno, Fabrizio Ferri Benedetti: https://passo.uno/
    • "The Seven-Action Documentation model", Fabrizio Ferri Benedetti: https://passo.uno/seven-action-model/
    • "Your docs are your infrastructure", The Stack Overflow Podcast: https://stackoverflow.blog/2024/11/26/your-docs-are-your-infrastructure/
    • "Czy dobra aplikacja potrzebuje instrukcji", Michał Skowron: https://www.slideshare.net/slideshow/czy-dobra-aplikacja-potrzebuje-instrukcji/83832453
    • Aleksandra Wieczorek-Konieczko, LinkedIn: https://pl.linkedin.com/in/techwriter-wieczorek
    Voir plus Voir moins
    1 h et 11 min
  • #73 Tech Writer podsumowuje rok 2024, czyli Tech Comm Wrapped
    Dec 22 2024

    Rok 2024 w komunikacji technicznej i w naszej pracy obfitował w ciekawe wydarzenia i projekty. Na naszych oczach powstawały nowe organizacje i inicjatywy, tworzyły się nowe trendy, a rzeczywistość technologiczna zmusiła nas do eksplorowania różnych rozwiązań. Krótko mówiąc, działo się!

    Dlatego, podążając za trendem wyznaczonym przez Spotify, postanowiliśmy stworzyć tech commowy Wrapped. Jest to nasze subiektywne podsumowanie najważniejszych rzeczy, które miały miejsce w komunikacji technicznej i w naszym życiu zawodowym w mijającym roku.

    Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

    Informacje dodatkowe:

    • Content Bytes (LinkedIn): https://www.linkedin.com/company/content-bytes
    • "Content Bytes - nowe oblicze spotkań dla specjalistów od treści", techwriter.pl: https://techwriter.pl/content-bytes-promo/
    • SAiIT (LinkedIn): https://www.linkedin.com/in/saiit-polska-03a008308/
    • "Stowarzyszenie Autorów i Ilustratorów Technicznych (SAIiT) - Wywiad z Łukaszem Rybką", techwriter.pl: https://techwriter.pl/saiit-wywiad/
    • "Stowarzyszenie Autorów i Ilustratorów Technicznych (SAiIT) - Spotkanie założycielskie", techwriter.pl: https://techwriter.pl/saiit-spotkanie-zalozycielskie/
    • "Stowarzyszenie Autorów i Ilustratorów Technicznych (SAiIT) - Początki działalności", techwriter.pl: https://techwriter.pl/saiit-spotkanie-zalozycielskie-relacja
    • soap! technical communication (LinkedIn): https://www.linkedin.com/company/soap-techcomm
    • "#63 Tech Writer poznaje moc języka w produktach cyfrowych, czyli dlaczego UX writing jest ważny", Tech Writer koduje: https://techwriterkoduje.pl/blog/2024/2/26/63
    • "UX writing. Moc języka w produktach cyfrowych", Wojciech Aleksander (Onepress): https://onepress.pl/ksiazki/ux-writing-moc-jezyka-w-produktach-cyfrowych-wojciech-aleksander,uxwri.htm
    • "Badanie płac w komunikacji technicznej 2024 – wypełnij ankietę!", techwriter.pl: https://techwriter.pl/badanie-plac-w-komunikacji-technicznej-2024
    • Artykuły, Tech Writer koduje: https://techwriterkoduje.pl/read
    • MeetContent: https://meetcontent.github.io/
    • Web Summer Camp: https://websummercamp.com/2025
    • Passo uno, Fabrizio Ferri Benedetti: https://passo.uno/
    • "#71 Tech Writer rozlicza się z semantic searcha, czyli plany kontra rzeczywistość", Tech Writer koduje: https://techwriterkoduje.pl/blog/2024/10/28/71
    • Adrian Wyka (LinkedIn): https://www.linkedin.com/in/adrianwyka/
    • Accens (LinkedIn): https://www.linkedin.com/company/accens
    • Zbójcerze Dostępności Kupują Prezenty (YouTube): https://www.youtube.com/playlist?list=PLrKAuW72u41T7PpjAshgiwspD9UCILIvU
    • "#16 DITA z Gita", Tech Writer koduje: https://techwriterkoduje.pl/blog/2020/4/22/16
    Voir plus Voir moins
    45 min
  • #72 Tech Writer pyta innych o docs as code, czyli kto i dlaczego porzuca CCMSy
    Nov 24 2024

    W przeszłości wielokrotnie dzieliliśmy się naszymi przemyśleniami na temat docs as code i CCMSów. Dlatego zamiast po raz kolejny głosić nasze zamiłowanie do rozwiązań niepochodzących od vendorów, postanowiliśmy zapytać innych o ich doświadczenia.

    Udało nam się znaleźć kilka osób, które uczestniczyły w migracji z CCMSa do docs as code i zgodziły się nam opowiedzieć o tym czy nowe rozwiązanie okazało się lekiem na całe zło czy gorzkim rozczarowaniem.

    Rozmawiamy o tym dlaczego ludzie porzucają CCMSy, oraz o wyzwaniach, niespełnionych oczekiwaniach i benefitach, czasem nieoczywistych, związanych z przejściem na docs as code.

    Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).

    Informacje dodatkowe:

    • "#65 Tech Writer broni docs as code, czyli klasyczne "u mnie działa"", Tech Writer koduje: https://techwriterkoduje.pl/blog/2024/4/29/65
    • "Are people abandoning docs as code?", Paweł Kowaluk: https://techwriterkoduje.pl/abandon-docs-as-code
    • "Docs as code is a broken promise", Sarah Moir: https://thisisimportant.net/posts/docs-as-code-broken-promise/
    • "Docs as Code", Write the Docs: https://www.writethedocs.org/guide/docs-as-code/
    • "Documentation as Code: why you need it and how to get started", Swimm Team: https://swimm.io/learn/code-documentation/documentation-as-code-why-you-need-it-and-how-to-get-started
    • "Component content management system (CCMS)", Wikipedia: https://en.wikipedia.org/wiki/Component_content_management_system
    • Git: https://git-scm.com/
    • Markdown: https://daringfireball.net/projects/markdown/
    • DITA (Darwin Information Typing Architecture): https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
    • DITA Open Toolkit (DITA OT): https://www.dita-ot.org/
    Voir plus Voir moins
    35 min