Update code documentation for Container API's to include best practices and also remove any stale unnecessary parts.