Automating Doc Builds So Writers Can Focus on Content.

Events > 2017 > February > Automating Doc Builds So Writers Can Focus on Content.

About this event:

Created by web master

Communitech Hub - Jelly Bean Meeting Room

To RSVP click this link:

Docs Like Code: What happens when you can change, review, and publish docs with automation techniques?

How does an open source project merge over 900 documentation changes in less than three months? At OpenStack, an open source cloud computing project, we treat docs like code. We continuously publish reviewed content from multiple repositories, backed by git, a version control system used by GitHub for many software projects. In this talk, Anne Gentle will describe how automation and CI/CD systems can be applied for documentation.

Continuous integration (CI) usually implies that the code is continually tested, integrated with other code changes, and then merged. Continuous deployment (CD) means the code is continuously deployed with each patch to the entire code base. In the case of documentation, it means the content is continuously tested, merged with each patch, and then published. For example, the HTML, CSS, and JavaScript output files are copied to a web server for all to see.

Bio: Anne Gentle works as a technical product manager at Cisco on the OpenStack project. She uses open source techniques for API design, documentation, devops, and developer support.

OpenStack provides open source cloud computing software through collaboration among more than 30 projects written in Python across hundreds of git repositories. She advocates for cloud users and administrators by providing accurate technical information to increase OpenStack adoption as a cloud for the world.

Prior to working on OpenStack in 2010, Anne worked as a community publishing consultant, providing strategic direction for professional writers who want to produce online content in collaborative ways. Her enthusiasm for community-based documentation methods prompted her to write a book about using social publishing techniques for technical documentation titled Conversation and Community: The Social Web for Documentation. She writes about open source and community techniques for web content development at

To RSVP click this link: