I don't think so. One of the best documentations out there (at least from those that I know) is the documentation for the Qt framework.
The most used container class, a QList, has in it's first sentence a pointer to other container classes, which discusses when you better use what container: <https://doc.qt.io/qt-5/qlist.html#details> \--- I think that most of the Qt documentation get's the balance between "reference" (attention to detail) and "introduction" (describing concepts) quite good. I like that the QList documentation points to other countainers. And that it discusses a bit which container to use, or better not to use. I dislike documentation that assume a CS background. If you only address CS absolvents, then you leave a lot of programmers on the side. And even if you assume that everyone has a strong CS background, then everyone would still no know if specialized container types are in the library. Or which names they have. People should learn that the S in CS is for science. While programming is often far away from science ...
