@@ -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"