fear of the bus - heidi waterhouse - devopsdays tel aviv 2016
TRANSCRIPT
@wiredferret #docsxdevops
Fear of the BusDocumentation and DevopsDevOpsDays Tel Aviv 2016
Heidi Waterhouse@wiredferret
@wiredferret #docsxdevops
Are you afraid of the bus?
@wiredferret #docsxdevops
Mt. Carmel Forest Fire
@wiredferret #docsxdevops
Racing to stay the same place
@wiredferret #docsxdevops
Castle Geyser
@wiredferret #docsxdevops
Bridges rely on redundancy
#docsxdevops
@wiredferret
Core principles
Everyone can touch the docs
Content matters more than presentation
Docs reduce burnout
@wiredferret #docsxdevops
Bad data is worse than missing data.
Missing data is worse than ugly data.
Ugly data saves lives
#docsxdevops
@wiredferret
3 Categories of DevOps
InfoWhat you need to keep
AutomatableStructuralSecret
@wiredferret #docsxdevops
Automatable
@wiredferret #docsxdevops
@wiredferret #docsxdevops
Structural
@wiredferret #docsxdevops
Jira is complex, but not thought-provoking
@wiredferret #docsxdevops
@wiredferret #docsxdevops
Secret
Secret information risks
What could happen if the data is lost?What could happen if the data is found by good actors?What happens if the data is found by bad actors?
@wiredferret #docsxdevops
Who has that password?
#docsxdevops
@wiredferret
Gotta beFindableUsableCurrent
#docsxdevops
@wiredferret
Low priorityPrettyFancyFriendly
@wiredferret #docsxdevops
Collecting
@wiredferret #docsxdevops
What do you have, and where is it?
@wiredferret #docsxdevops
What are people using?
@wiredferret #docsxdevops
Post-it notes run the world
PunchlistPeople responsibleWorkflowSupport infoDependencies
General information types
@wiredferret #docsxdevops
Finding
@wiredferret #docsxdevops
@wiredferret #docsxdevops
Blue screen of death
@wiredferret #docsxdevops
Unique emoji
@wiredferret #docsxdevops
Disposing
@wiredferret #docsxdevops
Data has an expiration date
@wiredferret #docsxdevops
One day of Flickr photos
#docsxdevops
@wiredferret
Testing is for
everyone
@wiredferret #docsxdevops
Chaos monkeys
@wiredferret #docsxdevops
Never call someone in the hospital
@wiredferret #docsxdevops
Docs prevent disaster
#docsxdevops
@wiredferret
tl;rt
Write it down, because that's easier and safer than remembering it.
@wiredferret #docsxdevops
Fear of the BusDocumentation and DevopsDevOpsDays Tel Aviv 2016
Heidi Waterhouse@wiredferret