Delivered at Kubecon US 2018 by Ben Hall. Watch the recording at https://www.youtube.com/embed/Yjxupg-NKnA
In this talk, Ben uses his expertise of building an Interactive Learning Platform to highlight The Art of Documentation. The aim of the talk is to help open source contributors understand how small changes to their documentation approach can have an enormous impact on how users get started.
Reading Large Blocks
Of Text is difficult
Writing Large Blocks
Of Text is painful
Commitment pattern (rare)
Consists of fixating on almost everything on the
Occurs when the eyes scan headings and
subheadings and skip the normal text below
Consists of skipping big chunks of text and scanning
as if looking for something specific, such as
a link, digits, a particular word.
"It deosn't mttaer in waht oredr the ltteers in a wrod
are, the olny iprmoetnt tihng is taht the frist and lsat
ltteer be at the rghit pclae. The rset can be a toatl
mses and you can sitll raed it wouthit porbelm. Tihs
is bcuseae the huamn mnid deos not raed ervey
lteter by istlef, but the wrod as a wlohe."