I've also noticed a lot more packages (npm mostly) with synopsis sections which essentially forms a 'full example', I find these immensely helpful.
One of the best documentations ive seen in the last time was from phalconPHP http://docs.phalconphp.com/en/latest/index.html
Well written and many comprehensible examples within in the doc.
I think, that writing a good documentaton is harder than programming.
I've also noticed a lot more packages (npm mostly) with synopsis sections which essentially forms a 'full example', I find these immensely helpful.