minor cleanups to docs/design for new containers (nothing really implemented)