conference logo

Playlist "openSUSE Virtual Conference 2021"

openSUSE documentation: Tame the beast, make it a friend

Adrien

Technical documentation is like the box of bandages in your bathroom cupboard: you don't know it exists unless you actually need it. And as it happens, it's when you need it the most that you find it half empty...

In this presentation we tell you everything you didn't know you wanted to know about the openSUSE documentation. You'll embark on a journey into the wild, from luxurious wikis to austere source-control platforms, where we'll try to widen your eyes on the importance of a central frame of reference, and on the numerous challenges standing in the way of discoverability and user-friendliness in the extremely rich and ever-evolving ecosystem of the openSUSE distributions. You'll be walked through the front line between users eager for technical facts and users eager for best-practices, and told about our approach, our ideas, and why you could actually have fun contributing.

This talk is proposed by Attila Pinter (adathor@prontonmail.com) and Adrien Glauser (nycticorax@opensuse.org)

Technical documentation is like the box of bandages in your bathroom cupboard: you don't know it exists unless you actually need it. And as it happens, it's when you need it the most that you find it half empty...

In this presentation we tell you everything you didn't know you wanted to know about the openSUSE documentation. You'll embark on a journey into the wild, from luxurious wikis to austere source-control platforms, where we'll try to widen your eyes on the importance of a central frame of reference, and on the numerous challenges standing in the way of discoverability and user-friendliness in the extremely rich and ever-evolving ecosystem of the openSUSE distributions. You'll be walked through the front line between users eager for technical facts and users eager for best-practices, and told about our approach, our ideas, and why you could actually have fun contributing.

This talk is proposed by Attila Pinter (adathor@prontonmail.com) and Adrien Glauser (nycticorax@opensuse.org)