start new API v1.17 docs

Signed-off-by: Jean-Tiare Le Bigot <jt@yadutaf.fr>
Upstream-commit: 800a8e896e810019b625ad0161c4fc4a04c26845
Component: engine

components/engine/docs/sources/reference/api/docker_remote_api.md

@@ -30,13 +30,26 @@ page_keywords: API, Docker, rcli, REST, documentation
    Client applications need to take this into account to ensure
    they will not break when talking to newer Docker daemons.
 
-The current version of the API is v1.16
+The current version of the API is v1.17
 
 Calling `/info` is the same as calling
-`/v1.16/info`.
+`/v1.17/info`.
 
 You can still call an old version of the API using
-`/v1.15/info`.
+`/v1.16/info`.
+
+## v1.17
+
+### Full Documentation
+
+[*Docker Remote API v1.17*](/reference/api/docker_remote_api_v1.17/)
+
+### What's new
+
+`POST /containers/(id)/attach` and `POST /exec/(id)/start`
+
+**New!**
+Docker client now hints potential proxies about connection hijacking using HTTP Upgrade headers.
 
 ## v1.16
 

components/engine/docs/sources/reference/api/docker_remote_api_v1.16.md

@@ -393,10 +393,8 @@ Get stdout and stderr logs from the container ``id``
 
 **Example response**:
 
-       HTTP/1.1 101 UPGRADED
+       HTTP/1.1 200 OK
        Content-Type: application/vnd.docker.raw-stream
-       Connection: Upgrade
-       Upgrade: tcp
 
        {{ STREAM }}
 
@@ -411,8 +409,7 @@ Query Parameters:
 
 Status Codes:
 
--   **101** – no error, hints proxy about hijacking
--   **200** – no error, no upgrade header found
+-   **200** – no error
 -   **404** – no such container
 -   **500** – server error
 
@@ -647,10 +644,8 @@ Attach to the container `id`
 
 **Example response**:
 
-        HTTP/1.1 101 UPGRADED
+        HTTP/1.1 200 OK
         Content-Type: application/vnd.docker.raw-stream
-        Connection: Upgrade
-        Upgrade: tcp
 
         {{ STREAM }}
 
@@ -668,8 +663,7 @@ Query Parameters:
 
 Status Codes:
 
--   **101** – no error, hints proxy about hijacking
--   **200** – no error, no upgrade header found
+-   **200** – no error
 -   **400** – bad parameter
 -   **404** – no such container
 -   **500** – server error
@@ -1752,18 +1746,7 @@ As an example, the `docker run` command line makes the following API calls:
 ## 3.2 Hijacking
 
 In this version of the API, /attach, uses hijacking to transport stdin,
-stdout and stderr on the same socket.
-
-To hint potential proxies about connection hijacking, Docker client sends
-connection upgrade headers similarly to websocket.
-
-    Upgrade: tcp
-    Connection: Upgrade
-
-When Docker daemon detects the `Upgrade` header, it will switch its status code
-from **200 OK** to **101 UPGRADED** and resend the same headers.
-
-This might change in the future.
+stdout and stderr on the same socket. This might change in the future.
 
 ## 3.3 CORS Requests