[both] Document and provide more samples for nesting containers

[zach-klippenstein]

Lots of questions and relevant discussion came up in #613, all those should be addressed with docs somewhere.

See also: #1210

[zach-klippenstein]

Since this is just a TODO for more samples, I'm removing from 1.0.0.