DevConf.CZ 2019

Let's hack on both docs content and tooling. We'll dig into Quick Docs, priority bugs, and wiki. We'll look at tooling, website, and branding. If you're an old hand, come whittle down the backlog. If you want to get started with Fedora docs, come learn about the team and get your hands dirty.

Yo, brothers of the open-source band
Let us see where you friends really stand.
Devz and docz, they’re gonna rap tonite
Dat where the struggle’s at, dat the fight!
Coders and writers -- they’ll do battle
To see who’s right, to prove their mettle!

In this here show you’ll both laugh and learn,
‘Cos that’s our game, the bread we earn.
From us to you, dear Free Soft nation
The power of collaboration.
An epic battle: the best show def;
Devz and docz -- can they go be-ef-ef?

Documentation is a first class citizen that is often ignored in an agile team. Docs becomes an afterthought, further down the waterfall after dev complete, yet still thought of as part of the W-Agile (Waterfall) team. Learn how we changed that perception, promoted documentation to be inclusive within the sprint process and removed the impediment to producing quality documentation as a releasable increment every sprint.

Are your project docs ready for quick consumption in the world of containerized, embedded, and other specialized software deployments? Can docs contributors keep up with the demand for new docs and maintenance at the same time? In this talk, Robert Kratky will describe how to tackle this problem: re-purposing the existing body of documentation into modular units that can be combined into user story-based content. Attendees can expect a presentation and discussion of ways to modernize existing documentation and adapt it for new expectations.

Got a broken README file, cryptic API reference, or cluttered Wiki site? The doc(tor)s can help! Get expert advice on questions like choosing the right markup language, naming things, restructuring content, or writing contribution guidelines. Open-source projects of all shapes and sizes are welcome!