Flock 2017 has ended
Back To Schedule
Wednesday, August 30 • 2:00pm - 5:00pm
Workshop: Turning Legacy Docs into User-Story-Based Content

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Fedora documentation is struggling to keep up with new developments. New docs don't get written, and existing docs are becoming obsolete. New contributors don't know where to start, and long-time Docs Team members are stretched thin.

This session will focus on teaching contributors to adapt existing docs and write new docs using a new format: modular units of content based on user stories. This will help reduce the amount of docs (easing the maintenance burden) as well as better serve users (targeting specific user stories).

A workflow based on easy-to-use templates will be introduced to allow quick on-boarding of new contributors and easy creation of both new docs and adaptation of legacy docs.

Following a brief intro and explanation of best practices, we will work with real docs to create tangible results and get people familiar with the process. The aim is to get the ball rolling and encourage contributors by making Fedora docs fun again.

What you need to know to get ready for this workshop

avatar for Robert Kratky

Robert Kratky

Technical Writer, Red Hat Czech

Wednesday August 30, 2017 2:00pm - 5:00pm EDT
3-Orleans A + B

Attendees (8)