cyrille martraire: living documentation jumpstart at i t.a.k.e. unconference 2015
TRANSCRIPT
![Page 1: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/1.jpg)
Living Documentation!Jumpstart Workshop
cyrille martraire!@cyriux
![Page 2: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/2.jpg)
What do you expect?
![Page 3: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/3.jpg)
![Page 4: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/4.jpg)
And could improve your code too?
![Page 5: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/5.jpg)
a source of frustration
![Page 6: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/6.jpg)
not enough outdated
CONSUMING DOC
![Page 7: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/7.jpg)
boring task prefer coding
PRODUCING DOC
![Page 8: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/8.jpg)
we can do better…
![Page 9: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/9.jpg)
much betterGood Documentation also
leads to better Design
![Page 10: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/10.jpg)
Workshop
![Page 11: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/11.jpg)
An existing Java project (from the USB drive)
!
☞ Explore, Change, Learn
![Page 12: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/12.jpg)
![Page 13: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/13.jpg)
Passionate developer
PARIS Since 1999
!
@cyriux
Cyrille Martraire
![Page 14: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/14.jpg)
Paris Software Craftsmanship Community
http://www.meetup.com/paris-software-craftsmanship/
![Page 15: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/15.jpg)
TDDBDDDDDLegacy
![Page 16: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/16.jpg)
Documentation
![Page 17: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/17.jpg)
Documentation(sorry)
![Page 18: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/18.jpg)
![Page 19: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/19.jpg)
USING MS OFFICE
![Page 20: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/20.jpg)
*NOT* CODING
![Page 21: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/21.jpg)
We love executable stuff
![Page 22: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/22.jpg)
Documentation, usually.
![Page 23: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/23.jpg)
Obsolete & Misleading
![Page 24: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/24.jpg)
Documentation Sucks
![Page 25: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/25.jpg)
I don’t want to maintain
documentation !
![Page 26: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/26.jpg)
![Page 27: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/27.jpg)
If we adopt a new mindset
![Page 28: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/28.jpg)
What is documentation?
Question:
![Page 29: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/29.jpg)
What is documentation?
![Page 30: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/30.jpg)
What is documentation?the purpose of
![Page 31: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/31.jpg)
Passing Knowledge
to other peopleTransmission
![Page 32: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/32.jpg)
Passing Knowledge
to other peopleMaking Accessible
![Page 33: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/33.jpg)
Passing Knowledge
for the futureMemory
![Page 34: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/34.jpg)
Passing Knowledge
for the futureCompliance
![Page 35: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/35.jpg)
KNOWLEDGE KNOWLEDGE KNOWLEDGE KNOWLEDGE
![Page 36: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/36.jpg)
DOCUMENTATION NEEDED
Long-run
Critical
Large Audience
![Page 37: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/37.jpg)
DOCUMENTATION NEEDED
No Waste
![Page 38: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/38.jpg)
DOCUMENTATIONBecause we can often do better than
documentation
NO
![Page 39: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/39.jpg)
MOST KNOWLEDGE IS
ALREADY THERE
Where?
ObfuscatedNon-Accessible
Fragmented
![Page 40: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/40.jpg)
![Page 41: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/41.jpg)
DOCUMENTATIONCapitalize on the knowledge that’s already there + a little bit more
NO
![Page 42: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/42.jpg)
CONVERSATIONS OVER
DOCUMENTATION
![Page 43: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/43.jpg)
!
!
Working Collectively
![Page 44: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/44.jpg)
Workshop Now!
![Page 45: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/45.jpg)
EVERGREEN DOCUMENT
1
![Page 46: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/46.jpg)
README.md What’s wrong?
![Page 47: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/47.jpg)
*Shamelessly stolen from the nicely presented competitor Fleetio Fleet Management solution*[Fleetio](https://www.fleetio.com/fuel-cards)!# Project Phenix(Fuel Card Integration)!Project Manager: Andrea Willeave!## Syncs dailyTransaction data from the pump is automatically sent to Fleetio. No more manual entry of fuel receipts or downloading and importing fuel transactions across systems.!## Fuel Card Transaction MonitoringTransaction data from the pump are verified automatically against various rules to detect potential frauds: gas leakage, transactions too far from the vehicle etc.!*The class responsible for that is called FuelCardMonitoring. Anomalies are detected if the vehicle is further than 300m away from the gas station, of if the transaction quantity exceeds the vehicle tank size by more than 5%* !## Odometer readingsWhen drivers enter mileage at the pump, Fleetio uses that information to trigger service reminders. This time-saving approach helps you stay on top of maintenance and keeps your vehicles performing their best.!*This module is to be launched in February 2015. Please contact us for more details.*!## Smart fuel managementMPG and cost-per-mile are automatically calculated. Analyze your fuel spend from all angles - by vehicle, location, vehicle type, time frame.!!## Customers Words
![Page 48: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/48.jpg)
Stable knowledge? Easy.
![Page 49: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/49.jpg)
*Shamelessly stolen from the nicely presented competitor Fleetio Fleet Management solution*[Fleetio](https://www.fleetio.com/fuel-cards)!# Project Phenix(Fuel Card Integration)!Project Manager: Andrea Willeave!## Syncs dailyTransaction data from the pump is automatically sent to Fleetio. No more manual entry of fuel receipts or downloading and importing fuel transactions across systems.!## Fuel Card Transaction MonitoringTransaction data from the pump are verified automatically against various rules to detect potential frauds: gas leakage, transactions too far from the vehicle etc.!*The class responsible for that is called FuelCardMonitoring. Anomalies are detected if the vehicle is further than 300m away from the gas station, of if the transaction quantity exceeds the vehicle tank size by more than 5%* !## Odometer readingsWhen drivers enter mileage at the pump, Fleetio uses that information to trigger service reminders. This time-saving approach helps you stay on top of maintenance and keeps your vehicles performing their best.!*This module is to be launched in February 2015. Please contact us for more details.*!## Smart fuel managementMPG and cost-per-mile are automatically calculated. Analyze your fuel spend from all angles - by vehicle, location, vehicle type, time frame.!!## Customers Words
![Page 50: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/50.jpg)
![Page 51: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/51.jpg)
Any Shameful Comments? Refactor!
![Page 52: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/52.jpg)
!
!
DOCUMENTATION
CODEis
2
![Page 53: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/53.jpg)
![Page 54: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/54.jpg)
Word Cloud3
![Page 55: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/55.jpg)
![Page 56: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/56.jpg)
56
What is this app about?
![Page 57: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/57.jpg)
You do it wrong!
![Page 58: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/58.jpg)
Word Cloud: dispatching + Discuss
![Page 59: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/59.jpg)
![Page 60: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/60.jpg)
Word Cloud: fuel card monitoring
+ Compare
![Page 61: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/61.jpg)
![Page 62: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/62.jpg)
LIVING GLOSSARY
4
![Page 63: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/63.jpg)
How do I representthe Ubiquitous Language
in practice?
![Page 64: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/64.jpg)
Annotate domain-relevant classesSource code as reference
![Page 65: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/65.jpg)
Living Glossary
Living Glossary Processor
Source Code & Annotations
Living Glossary always up-to-date
![Page 66: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/66.jpg)
Run the Living Glossary
![Page 67: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/67.jpg)
Custom Doclet to export Living Glossary
![Page 68: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/68.jpg)
Bounded Context comment
![Page 69: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/69.jpg)
Core Concepts
![Page 70: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/70.jpg)
Class comment
![Page 71: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/71.jpg)
ANOTHER EXAMPLESent directly to end customers every week
![Page 72: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/72.jpg)
Run the Living Glossary Make changes to the code
rename move to /infra
remove annotations change comments
![Page 73: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/73.jpg)
KNOWLEDGE AUGMENTATION
![Page 74: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/74.jpg)
Code
![Page 75: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/75.jpg)
Bounded Contexts are there
![Page 76: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/76.jpg)
Bounded Contexts are there
Implicitly
![Page 77: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/77.jpg)
Annotations
![Page 78: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/78.jpg)
Bounded Contexts
![Page 79: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/79.jpg)
Embedded Learning
![Page 80: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/80.jpg)
Embedded Learning
![Page 81: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/81.jpg)
Embedded Learning
![Page 82: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/82.jpg)
Embedded Learning
![Page 83: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/83.jpg)
Embedded LearningLearn on the job
![Page 84: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/84.jpg)
LIVING DIAGRAM
4
![Page 85: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/85.jpg)
Run the Living Diagram
![Page 86: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/86.jpg)
Living Diagram
Living Diagram
Processor
Source Code
Living Diagram always up-to-date
![Page 87: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/87.jpg)
Run the Living Diagram Make changes to the code Run the Living Diagram
![Page 88: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/88.jpg)
Example: Hexagonal Architecture
![Page 89: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/89.jpg)
Domain Model inside Infrastructure Outside
![Page 90: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/90.jpg)
Design is already there
![Page 91: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/91.jpg)
Design is already thereImplicitly
![Page 92: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/92.jpg)
Just rely on documented naming conventions
![Page 93: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/93.jpg)
*.domain!*.infra!NOT *Test
![Page 94: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/94.jpg)
Living Diagram
Living Diagram
Processor
Source Code
Living Diagram always up-to-date
![Page 95: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/95.jpg)
95
tada!
![Page 96: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/96.jpg)
![Page 97: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/97.jpg)
CONTENT FILTERING (CURATION)
is KEY
![Page 98: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/98.jpg)
![Page 99: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/99.jpg)
No Value
![Page 100: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/100.jpg)
![Page 101: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/101.jpg)
1 Diagram 1 Purpose
![Page 102: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/102.jpg)
Example: Hexagonal Architecture
![Page 103: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/103.jpg)
![Page 104: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/104.jpg)
Fix the code Run the Living Diagram
![Page 105: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/105.jpg)
![Page 106: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/106.jpg)
OOPS!
![Page 107: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/107.jpg)
Reality Check
![Page 110: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/110.jpg)
LISTEN TO THE DOCUMENTATION
FRUSTRATIONS
![Page 111: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/111.jpg)
Hard to do the Living Glossary?
A signal!
![Page 112: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/112.jpg)
Hard to do the Living Diagrams?
A signal!
![Page 113: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/113.jpg)
Programming by
Coincidence
![Page 114: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/114.jpg)
![Page 115: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/115.jpg)
Know what you’re doing ->
Already half-documented
![Page 116: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/116.jpg)
ANYBODY CAN !APPRECIATE!IT’S A MESS
![Page 117: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/117.jpg)
PRESSURE TO !IMPROVE DESIGN
![Page 118: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/118.jpg)
Simpler Design Less documentation needed
![Page 119: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/119.jpg)
More standard Less documentation needed
!fogus
@fogus
![Page 120: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/120.jpg)
Fix your workflow
Write code Write tests Write doc
Write tests = write doc Write code = write doc
From Mikko Ohtamaa
![Page 121: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/121.jpg)
COOL!
![Page 122: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/122.jpg)
In Closing
![Page 123: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/123.jpg)
https://leanpub.com/livingdocumentation
BUY MY BOOK!
![Page 124: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/124.jpg)
![Page 125: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/125.jpg)
![Page 126: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/126.jpg)
Boring Documentation is dead
Long Live Living Documentation!
![Page 127: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/127.jpg)
Not about particular techniques
!
Reconsider dealing with the knowledge
![Page 128: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/128.jpg)
Share Your Ideas & Experiments
![Page 129: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/129.jpg)
![Page 130: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/130.jpg)
Questions? Did you try similar things too?
Let’s discuss!@cyriux
![Page 131: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/131.jpg)
Follow me @cyriux !
Slides: slideshare.net/cyriux Blog: cyrille.martraire.com
!
In Paris? Join !
![Page 132: Cyrille Martraire: Living Documentation Jumpstart at I T.A.K.E. Unconference 2015](https://reader030.vdocuments.net/reader030/viewer/2022032504/55c3594ebb61eb431f8b476c/html5/thumbnails/132.jpg)
Merci