ask what your DevOps can do for your docs? · 2017-12-14 · ask what your DevOps can do for...

ask what your DevOps can do for your... docs?

Mikey ArielLinuxCon / CloudOpen Europe, October 2015

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

who am I?

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

times are a' changing...

Documentation is a key component of successful software

Documentation is an afterthought of software delivery

Incrementally developed software is released early and often

Feature-heavy software is developed and released slowly

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

how documentation can help software

Unified and intuitiveuser experience

Portable and adoptable workflow

Scalable and adaptable project

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

how DevOps can help documentation

Unified and intuitiveuser experience

Portable and adoptable workflow

Scalable and adaptable project

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

DevOpsfor Docs

unified toolchain

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

universal platform

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

standardized review flow

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

live preview

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

out-of-the-box publication

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

DevOpsfor Docs

continuous integration

unified toolchain

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

automatic builds

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

continuous staging

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

DevOpsfor Docs

continuous integration

automation

unified toolchain

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

sanity checks

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

unit tests

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

DevOpsfor Docs

continuous integration

Iterative authoring

automation

unified toolchain

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

before...

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

… after!

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

… after!

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

… after!

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

DevOpsfor Docs

continuous integration

Iterative authoring

collaborationautomation

unified toolchain

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

we're all in this together

Designers

Developers

Product Managers

Quality Assurance

Support Engineers

Users

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

docs or it didn't happen

django project

linux kernel

OpenStack

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

contribution guidelines

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

templates

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

workshops and hackfests

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

conferences and communities

LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

DevOpsfor Docs

continuous integration

Iterative authoring

collaborationautomation

unified toolchain

THANK YOU!

mariel@redhat.com@ThatDocsLady

@oVirt@writethedocs