Docker Engine API overview

[sarahsanders-docker]

Is this a docs issue?

• My issue is about the documentation content or website

Type of issue

Other

Description

Task: Read through the v1.49 Docker Engine API overview. What’s confusing or unclear? Suggest wording improvements for newcomers.

Location

https://docs.docker.com/reference/api/engine/version/v1.49/

Suggestion

No response

[migue1s]

Taking this one!

[migue1s]

Some feedback, left here since I found it a bit hard to create a PR at WTD

false Return the size of container as fields SizeRw and SizeRootFs.

What is SizeRw and SizeRootFs? They are defined in the response but not in the initial usage

The names associated with this container. Most containers have a single name, but when using legacy "links", the container can have multiple names.

Could we have a link to the legacy links?

The hostname to use for the container, as a valid RFC 1123 hostname.

What is RFC 1123?

Whether to attach to stdin.

How much are we assuming people will know when going into this docs about stding/stdout? Can we exapnd on this description in case our users are unfamiliar

Close stdin after one attached client disconnects

What are the use cases for this?

[migue1s]

Someone else can feel free to take this. Going to jump to a different project