doc and tests for `container :type`

includes some minor tweaks/re-ordering in docs
Merge pull request #6463 from rolandwalker/doc_new_container_type

doc and tests for `container :type`