ZOI-9520 Developer’s Torment: The Documentation | Devoxx

Devoxx Poland 2019
from Monday 24 June to Wednesday 26 June 2019.

   Developer’s Torment: The Documentation


Methodology & Culture
Methodology & Culture
Beginner & novice level
Room 2 Tuesday from 11:30 til 12:20

You start a new job. You’re excited - new domain, new knowledge to ingest, new practices to learn. Unfortunately, once you start digging into things, excitement starts to fade and is replaced by frustration. It turns out that there is no way to find out about the product unless you somehow get a hold of sales pitch presentation. You can only learn about architecture if you talk to “that guy” and only if he’ll have 3 hours to spare (spoiler alert: he won’t). In short - tribal knowledge is the only way to go. Docs say we use Cassandra to store our data? Well, we did - in 2010.

Is there no way out of this hell? Does onboarding process have to be the rite of passage, where your enthusiasm is crushed by the heavy weight of hopelessness? How to write and maintain documentation in the way, that it is an actual advantage to you and yours, and not a pile of shame?

During our talk, we’ll analyze what are the actual issues with the docs, do we actually need it and how to go with quality, not quantity. Don’t worry, we won’t leave you without the tools to tackle this beast.

Subscribe to Devoxx on YouTube
Jakub Marchwicki
Jakub Marchwicki
From Casumo

Jakub is a software craftsman with over a decade of commercial experience in programming, wearing multiple hats, getting hands dirty in multiple environments. Some languages, some frameworks, blah blah blah - doesn’t really matter. Architect, programmer, manager, technical trainer, tech lead, wannabe entrepreneur, JUG leader. There is a fair chance he does non of those right.

Zbyszko Papierski
Zbyszko Papierski
From Dynatrace

Software engineer/architect, with strong addiction to product side of the solution. Previously responsible for useful categorization in Allegro, nicer API in Jira and lately for better Log Analytics in Dynatrace. After hours handles code-related Tricity JUG initiatives (like Hackengarten) in the meanwhile trying to learn his first (and probably last) oriental language.

Make sure to download the Android or iOS mobile schedule.