Documentation Continuous Delivery – INTRODUCTION – ACCEPTANCE CRITERIA

View Github Repository Open presentation in a new window

derberg

See all presentation from derberg

Documentation Continuous Delivery – INTRODUCTION – ACCEPTANCE CRITERIA

0 0

dcd-in-action

Presentation about Documentation Continuous Delivery in Action

On Github derberg / dcd-in-action

Documentation Continuous Delivery

in Action

Created by Łukasz Górnicki / @derberqWorking on YaaS in hybris software An SAP Company

INTRODUCTION

Where can you use this approach?

What you need to change in our organisation?

  • Spotify's Scaling Agile with Tribes, Squads, Chapters
  • Organize Your Company Around Your Business Plan
  • Scaled Agile Framework (SAFe) - you don't want to do this

What are the costs?

Documentation solutions out there

  • DITA
  • Wiki like
  • Strange software like MadCap Flare and others
  • Static site generators

ACCEPTANCE CRITERIA

Multiple Independent Teams

Unlimited Number of Topics

Content Delivered Constantly

Developer Friendly

Implementation

Parts of solution:

  • Git repos with code and docu content
  • Content delivered in simple syntax
  • Registry of all docu topics
  • Content integration module
  • Static content generation
  • Continuous integration to deliver docu portal
  • Hosting in private cloud

Do It Yourself!

Parts of solution:

  • Git repos with code and docu content: GitHub
  • Content delivered in markdown and html: Markdown
  • Registry of all docu topics: GitHub
  • Content integration module: Gulp
  • Static content generation: DocPad
  • Continuous integration to deliver docu portal: Travis CI
  • Hosting in private cloud: GitHub Pages

Demo Time!

Thanks!

YaaS Dev Portal: https://devportal.yaas.ioThis presentation: http://derberg.github.io/dcd-in-action Previous presentation: http://derberg.github.io/documentation-continuous-delivery Recording of previous presentation (Polish): https://www.youtube.com/watch?v=F-1goNbdBkc ExTW blog: http://derberg.github.io/ GitHub: derberg Twitter: @derberq DocPad: https://docpad.org/ reveal.js: https://github.com/hakimel/reveal.js

Documentation Continuous Delivery in Action Created by Łukasz Górnicki / @derberq Working on YaaS in hybris software An SAP Company