they gotta start writing docs for people with ADHD
nobody reading your wall of text to explain an example
they will unconsciously scan it for information & reference the examples they don't yet understand for CONTEXT
you've got a paragraph of info not cleanly laid out? it ain't going into their head