Zagreb Software Crafters

🇭🇷 Svi cijene dobro napisanu dokumentaciju. Ipak, kad se radi o vlastitim projektima, često dajemo prednost brzini i potpuno preskočimo dokumentaciju. Nemamo vremena čitati, a kamoli pisati stranice teksta. No, kad se nađemo pred zadatkom razumijevanja koda koji je napisao kolega — ili čak mi sami u prošlosti — shvatimo koliko nam zapravo nedostaju objašnjenja.

U ovom predavanju istražit ćemo što zapravo znači softverska dokumentacija, koje sve formate može imati i kako odabrati pravi pristup dokumentiranju za različite vrste projekata. Također ćemo raspraviti tehnike pisanja samodokumentirajućeg koda koje olakšavaju razumijevanje budućim čitateljima, smanjujući potrebu za formalnom dokumentacijom bez gubitka jasnoće.

🇬🇧 Everyone appreciates well-written documentation. Yet, when it comes to our own projects, we often prioritize speed, and skip the documentation altogether. We don’t have the time to read, let alone write, pages of text. However, when we’re faced with understanding code written by a colleague—or even our past selves—we find ourselves longing for explanations.

In this talk, we’ll explore what software documentation really is, the various formats it can take, and how to choose the right documentation approach for different types of projects. We’ll also discuss techniques for writing self-documenting code that enhances understanding for future readers, minimizing the need for formal documentation without compromising clarity.

🇭🇷 U ovom predavanju istražiti ćemo Trunk-Based Development (TBD) — pojednostavljeni model grananja u sustavima za verzioniranje koda, osmišljen za podršku continuous integration & continuous delivery pristupu. Usporediti ćemo ga s tradicionalnim grananjem po feature-ima, istaknuti kako TBD poboljšava suradnju i brzinu dostavljanja feature-a te raspraviti što je potrebno za njegovu uspješnu primjenu. Predavač će podijeliti osobna iskustva zajedno s primjerima iz stvarnog svijeta iz različitih dijelova industrije.

🇬🇧 In this talk, we’ll explore Trunk-Based Development (TBD) — a streamlined source control branching model designed to support continuous integration and continuous delivery. We’ll compare it to traditional feature branching, highlight how TBD improves collaboration and release velocity, and discuss what’s needed to implement it successfully. The speaker will share personal experiences along with real-world case studies from across the industry.