{14th STC India Annual Conference} Open Writing! Collaborative Authoring for CloudStack Documentation
STC India Conference
Description
We'll talk about how we designed tools and processes to both support our own writing and encourage contribution from the community, and the best practices we developed along the way. We will also candidly reveal the challenges of creating a community around an open-source documentation project, and moving from a single-company focus to a community focus.
Abstract
What it makes to become an Open-Source Writer : The Pain and the Fun
Life of an Open-Source Documentation writer
Mechanics of the Apache CloudStack Documentation Project: tools, process, and best practices
· The advantages of using Publican to generate various output formats from Docbook XML
· Our modular, topic-based doc repository checked in to git source control and tailored for easy chunking, reuse, and localization
· How we achieve localization
· Continuous doc build: keeping it green
· Documentation reviews
· Tips and tricks
Challenges in setting up and managing an open-source documentation community
· What makes working with the open-source contributors different from working within a company?
· Publicizing the opportunity to contribute to documentation
· Participating in mailing lists, IRC chat, and other communication channels
· Moderating discussions in a group known for frank opinions stated boldly
Call to Action
· How to contribute to CloudStack documentation
· Who can contribute
· Where to find out more
Presenters
Jessica T, Radhika PC
Registration