Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Ask what your DevOps can do for your... Docs?

Ask what your DevOps can do for your... Docs?

DevOps? DocOps? WhateverOps! Whatever label you use, DevOps is basically a collection of best practices that, when used together, aim to assist in effective software development. And with so much innovation around DevOps, what's stopping us from applying the same best practices to achieve effective documentation development?

As presented at LinuxCon / CloudOpen Europe: http://sched.co/3xT9

thatdocslady

October 06, 2015
Tweet

More Decks by thatdocslady

Other Decks in Technology

Transcript

  1. ask what your DevOps can do
    for your... docs?
    Mikey Ariel
    LinuxCon / CloudOpen Europe, October 2015

    View Slide

  2. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    who am I?

    View Slide

  3. 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

    View Slide

  4. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    how documentation can help software
    Unified and intuitive
    user experience
    Portable and adoptable
    workflow
    Scalable and adaptable
    project

    View Slide

  5. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    how DevOps can help documentation
    Unified and intuitive
    user experience
    Portable and adoptable
    workflow
    Scalable and adaptable
    project

    View Slide

  6. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    DevOps
    for Docs
    unified
    toolchain

    View Slide

  7. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    universal platform

    View Slide

  8. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    standardized review flow

    View Slide

  9. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    live preview

    View Slide

  10. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    out-of-the-box publication

    View Slide

  11. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    DevOps
    for Docs
    continuous
    integration
    unified
    toolchain

    View Slide

  12. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    automatic builds

    View Slide

  13. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    continuous staging

    View Slide

  14. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    DevOps
    for Docs
    continuous
    integration
    automation
    unified
    toolchain

    View Slide

  15. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    sanity checks

    View Slide

  16. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    unit tests

    View Slide

  17. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    DevOps
    for Docs
    continuous
    integration
    Iterative
    authoring
    automation
    unified
    toolchain

    View Slide

  18. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    before...

    View Slide

  19. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    … after!

    View Slide

  20. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    … after!

    View Slide

  21. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    … after!

    View Slide

  22. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    DevOps
    for Docs
    continuous
    integration
    Iterative
    authoring
    collaboration
    automation
    unified
    toolchain

    View Slide

  23. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL

    View Slide

  24. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    we're all in this together
    Designers
    Developers
    Product Managers
    Quality Assurance
    Support Engineers
    Users

    View Slide

  25. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    docs or it didn't happen
    django project
    linux kernel
    OpenStack

    View Slide

  26. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    contribution guidelines

    View Slide

  27. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    templates

    View Slide

  28. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    workshops and hackfests

    View Slide

  29. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    conferences and communities

    View Slide

  30. LinuxCon / CloudOpen Europe 2015 | MIKEY ARIEL
    DevOps
    for Docs
    continuous
    integration
    Iterative
    authoring
    collaboration
    automation
    unified
    toolchain

    View Slide

  31. THANK YOU!
    [email protected]
    @ThatDocsLady
    @oVirt
    @writethedocs

    View Slide