Devoxx Poland 2019
from Monday 24 June to Wednesday 26 June 2019.
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.
Developer’s Torment: The Documentation
Jakub Marchwicki
(Casumo)
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.