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