I get the point they're making but I really like FAQ's. They help with the "know what you don't know" sort of thing at a glance. Perhaps not useful on a gov.uk site, but generally speaking.
145 karma · joined December 12, 2014
[1] https://www.keyboardmaestro.com/ [2] https://gist.github.com/chroder/a18178940cd1e96a76c4daea63dc... [3] https://i.imgur.com/UEjDfNJ.png
Library code might be a little ugly and abstract, but as an end-developer, you usually don't need to worry about it. The code you yourself would see and write is going to have a lot more meaning and be more understandable.
I've rarely had to do anything fancy with generics in my own projects. Where I've seen it be most useful is when I want to offer a flexible public API -- in which case, the choice of writing a bit of generic library code is much less smelly than copy pasta.