![Page 1: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/1.jpg)
@docdepartment
DevOps DocumentationManaging documentation in a shared ownership
environment
![Page 2: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/2.jpg)
@docdepartment@docdepartment
![Page 3: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/3.jpg)
@docdepartment@docdepartment
increase in revenue from product
collaborations
15%
www.atkearney.com/innovation/collaborative-innovation
![Page 4: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/4.jpg)
@docdepartment@docdepartment
collaboration
![Page 5: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/5.jpg)
@docdepartment@docdepartment
find teammates who do
something you can’t
![Page 6: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/6.jpg)
@docdepartment@docdepartment
![Page 7: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/7.jpg)
@docdepartment@docdepartment
“social” business uses social
technology to foster collaboration
IBMSocialStudy, 2014
74%
![Page 8: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/8.jpg)
@docdepartment@docdepartment
strategy first
technology follows
![Page 9: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/9.jpg)
@docdepartment@docdepartment
![Page 10: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/10.jpg)
@docdepartment@docdepartment
![Page 11: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/11.jpg)
@docdepartment@docdepartment
create and maintain
documentation required by
product or service produced as
result of collaboration
![Page 12: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/12.jpg)
@docdepartment@docdepartment
material that provides
official information
or evidence,
or material that serves as a
record
![Page 13: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/13.jpg)
@docdepartment@docdepartment
tech comms framework
is
content strategy
![Page 14: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/14.jpg)
@docdepartment@docdepartment
content strategy
content
design
process
standards
Information / content model
style guide | DITA | DocBook
CSS | template
agile | waterfall | kanban
PDF | xliff | SCORM
![Page 15: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/15.jpg)
@docdepartment@docdepartment
waterfall
spiral
v-shaped
iterative
open source
Serial (>)Develop > Document > Translate
Parallel ( )Develop
Document
Translate
Collective ()Develop
Document
Translate
Virtual Collaborative Writing in the Workplace, Hewett & Robidoux
![Page 16: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/16.jpg)
@docdepartment@docdepartment
monarchy
hierarchy
democracy
consensus
anarchy
scale pace qual.
Virtual Collaborative Writing in the Workplace, Hewett & Robidoux
![Page 17: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/17.jpg)
@docdepartment@docdepartment
content strategy
content
design
process
standards
In. Ar TC
SME
>
TC >
UX
UI >
TC
![Page 18: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/18.jpg)
@docdepartment@docdepartment
collaboration between
development and operations to
create, deliver and operate
a product or service
Anne Gentle, 2009
![Page 19: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/19.jpg)
@docdepartment@docdepartment
2 weeks 2 weeks
Service Desk
NOC
Docs [email protected]
DevOps
x x2 weeks
Development Operations
![Page 20: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/20.jpg)
@docdepartment@docdepartment
documentation as a
conversation
Anne Gentle, 2009
![Page 21: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/21.jpg)
@docdepartment@docdepartment
o framework
o synchronous comms
o transparent & open
o collaborative
![Page 22: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/22.jpg)
@docdepartment@docdepartment
content strategy
tools
design
process
standards
TC >
TC
PO
TC TC
Dev Ops
![Page 23: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/23.jpg)
@docdepartment@docdepartment
content
troubleshooting
product
system arch.
system design
3rd party
Dev Ops
TC
Ops
Dev
Ops
DevO
ps
![Page 24: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/24.jpg)
@docdepartment@docdepartment
Development Operations
Service Desk
NOC
K’ Base
DevOps
2 weeks
documentation as a conversation
![Page 25: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/25.jpg)
@docdepartment@docdepartment
o deconstruct documentation
o create framework
o manage each piece
appropriately
![Page 26: DevOps documentation: Manage documentation in a shared ownership environment](https://reader031.vdocuments.site/reader031/viewer/2022022001/587b991f1a28ab4e4f8b704d/html5/thumbnails/26.jpg)
@docdepartment@docdepartment