Topconf Tallinn 2016

TRACK: Sustainable Development

Documentation avoidance for developers

However good your code, other people never seem to get it. Instead they ruin your day (and your productivity) by asking questions and expecting documentation. You need to know how to explain code without getting stuck in meetings or spending half your time on the only thing you hate more than meetings: writing documentation. Instead, you aim for constructive laziness: tactics that give you more time to write code. This talk teaches you how to avoid writing documentation, by making it unnecessary or delegating the work to someone else. You will also learn how to deal with the awkward situation when you can’t away with avoidance or delegation, and have to write the documentation yourself. This talk explores what we talk about when we talk about code, how we do it, and the tools we use. You can often find a better tool than documentation, but not always. Not everyone writes detailed specifications these days, but remote working and distributed teams make written explanations more valuable than ever. Talking face to face requires less effort, but you rarely or never meet the authors of most of the code you see. Software craftsmanship has failed to make written documentation unnecessary. Instead we shall turn to README-Driven Development, comments evasion, documentation-avoidance, just-in-time documentation and the art of not writing it in the first place.

Peter Hilton

software developer
freelance

date

2016-11-16

starts

15:30

ends

16:10

room

Bolero 2

level

Intermediate

topics

documentation, coding, software maintenance, maintainability, techniques, craftsmanship

OTHER TALKS YOU MIGHT BE INTERESSTED IN ...

starts

2016-11-16, 10:20

room

Bolero 2

starts

2016-11-16, 11:10

room

Bolero 2

starts

2016-11-16, 12:00

room

Bolero 2

starts

2016-11-16, 13:40

room

Bolero 2

starts

2016-11-16, 14:30

room

Bolero 2

starts

2016-11-16, 16:20

room

Bolero 2