January 29, 2020

200 words 1 min read

(How to) Be a Good Citizen in Open-Source Documentation

(How to) Be a Good Citizen in Open-Source Documentation

Open-source projects struggle with documentation – it is often cited as the weak spot of open source. Many projects have failed to attract docs contributors, and many companies that contribute code d …

Talk Title (How to) Be a Good Citizen in Open-Source Documentation
Speakers Robert Kratky (Principal Technical Writer, Red Hat)
Conference Open Source Summit + ELC Europe
Conf Tag
Location Lyon, France
Date Oct 27-Nov 1, 2019
URL Talk Page
Slides Talk Slides
Video

Open-source projects struggle with documentation – it is often cited as the weak spot of open source. Many projects have failed to attract docs contributors, and many companies that contribute code don’t have processes for working with upstream docs. How can you, both as a corporate and individual contributor, help to create a healthy documentation set? What are best practices for writing and maintaining open docs?This session will introduce attendees to basic principles of fitting docs work into the open-source collaboration model. You will learn about open-source documentation what you may already know about open-source code: how to be a good community member, how to contribute meaningfully, and how to ensure the resulting docs serve the community well and can also be downstreamed easily.

comments powered by Disqus