We're sorry but this page doesn't work properly without JavaScript enabled. Please enable it to continue.
Feedback

Writing Open Source Documentation for Open Source Projects

Formale Metadaten

Titel
Writing Open Source Documentation for Open Source Projects
Untertitel
How SUSE is documented and what we can learn from it
Serientitel
Anzahl der Teile
611
Autor
Lizenz
CC-Namensnennung 2.0 Belgien:
Sie dürfen das Werk bzw. den Inhalt zu jedem legalen Zweck nutzen, verändern und in unveränderter oder veränderter Form vervielfältigen, verbreiten und öffentlich zugänglich machen, sofern Sie den Namen des Autors/Rechteinhabers in der von ihm festgelegten Weise nennen.
Identifikatoren
Herausgeber
Erscheinungsjahr
Sprache
Produktionsjahr2017

Inhaltliche Metadaten

Fachgebiet
Genre
Abstract
To publish it's documentation, SUSE has developed not only a comprehensiveOpen Source toolchain to create and publish documentation but also an openworkflow that allows community and partners to provide feedback andcontribute. These tools and processes can easily be adopted by other projectsto write high quality software documentation. SUSE has been around as Linux vendor for a long time and from it's early daysonwards, delivered not only software but also the documentation to use it. Infact, SUSE is not only writing the documentation for it's own distributionsbut for upstream projects like OpenStack as well. Over time, the SUSEdocumentation team has developed not only a comprehensive, completely Free andOpen Source toolchain to create, edit, manage, and publish documentation butalso an open workflow that allows community and partners to provide feedbackand contribute. These tools and processes can easily be adopted by otherprojects to write high quality software documentation, everything from a manpage to a reference guide. In this talk, Christoph will introduce the complete SUSE/openSUSEdocumentation workflow and tool chain. It will cover both the technicaldetails like formats, tools, or branching model and the organizational aspectssuch as the feature planning and tracking, distribution of work and feedbackprocess.