doc and tests for `container :type`

includes some minor tweaks/re-ordering in docs