Merge pull request #33549 from ripcurld0/update_swagger

Describe the differences between container-inspect and container-list
Upstream-commit: 36db52a7049c0f00e75f7cfcbd5061dc7600180f
Component: engine

components/engine/api/swagger.yaml

@@ -2698,6 +2698,11 @@ paths:
   /containers/json:
     get:
       summary: "List containers"
+      description: |
+        Returns a list of containers. For details on the format, see [the inspect endpoint](#operation/ContainerInspect).
+
+        Note that it uses a different, smaller representation of a container than inspecting a single container. For example,
+        the list of linked containers is not propagated .
       operationId: "ContainerList"
       produces:
         - "application/json"