library-level docs for collections

Adds a high-level discussion of "what collection should you use for what", as well as some general discussion of correct/efficient usage of the capacity, iterator, and entry APIs.

Still building docs to confirm this renders right and the examples are good, but the content can be reviewed now.
I elaborate a bit on this relationship in my incoming docs for BTreeMap. I could direct the reader to there for more detail?