NOTE: The event will be held in Central Daylight Time (CDT), UTC -5.

View More Details for Open Source Summit + Embedded Linux Conference North America 2020
Registration Information.
Back To Schedule
Monday, June 29 • 3:20pm - 3:45pm
Ensuring That Documentation Is a First-class Citizen in Open Source Projects - Ray Paik, GitLab & Sofia Wallin, Ericsson Software Technology

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

Feedback form is now closed.
We often see many open source projects struggle with maintaining quality documentation and finding contributors who are interested in helping with project documentation. There are a number of reasons for this, such as many viewing documentation as a separate product from code, or even a belief that people should be able to make sense of what the code is doing by reading the code itself.

For these and other reasons, documentation work is often done at the last minute, and done by people with low motivation and minimum effort. So the quality of the output will naturally suffer. These issues can be addressed by making sure that documentation is everyone’s responsibility and that documentation is a core part of the product and is created using the same development and community processes.

In this session, Sofia will share her learnings as a documentation project lead in OPNFV and ONAP, and how their best practice is used throughout Linux Foundation Networking. Ray will discuss how community contributions are managed for GitLab documentation, and how community members are able to apply their experience from documentation work to future contributions to other areas of GitLab.


Sofia Wallin

Open Source Project Manager, Ericsson Software Technology
As part of the Ericsson Software Technology (EST) organization, Sofia is involved in driving open source engagements, supporting in establishing the EST business and act as an advocate for open source throughout Ericsson. She is the technical lead for documentation within Linux Foundation... Read More →
avatar for Ray Paik

Ray Paik

Community Manager, GitLab
Ray is a Community Manager at GitLab where he is helping to grow the community of contributors to GitLab. Prior to GitLab, Ray was responsible for the day-to-day operation of the Open Platform for NFV (OPNFV) community since its launch in 2014. He has over 15 years of experience in... Read More →

Monday June 29, 2020 3:20pm - 3:45pm CDT
OS Project Updates Theater