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

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!
    mariel@redhat.com
    @ThatDocsLady
    @oVirt
    @writethedocs
    

    View Slide