docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Revert "Add pointer to latest API ref" (#4896) 

* Revert "Clarify patch and update cycles (#4894)"

This reverts commit 6b1577aa0d.

* Revert "Add pointer to latest API ref (#4892)"

This reverts commit a6b436d133.
This commit is contained in:
John Mulhausen 2017-10-11 16:33:21 -07:00 committed by GitHub
parent 6b1577aa0d
commit 8b704f7b87
4 changed files with 7 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
_config.yml
View File

@ -15,7 +15,6 @@ keep_files: ["v1.4", "v1.5", "v1.6", "v1.7", "v1.8", "v1.9", "v1.10", "v1.11", "
# Component versions -- address like site.docker-ce_stable_version
docker-ce_stable_version: "17.09"
latest_stable_docker_engine_api_version: "1.32"
docker-ce_edge_version: "17.09"
docker-ee_version: "17.06"
compose_version: "1.16.1"

8
_data/toc.yaml
View File

@ -1,5 +1,3 @@
---
---
horizontalnav:
- title: Guides
path: /
@ -608,12 +606,10 @@ reference:
title: Get started
- path: /engine/api/sdks/
title: SDKs
- path: /engine/api/latest/
title: v{{ latest_stable_docker_engine_api_version }} Reference
- sectiontitle: API reference by version
section:
- path: /engine/api/v1.32/
title: v1.32 Reference
- sectiontitle: Previous API versions
section:
- path: /engine/api/version-history/
title: Version history overview
- path: /engine/api/v1.31/

15
develop/sdk/index.md
View File

@ -44,16 +44,10 @@ go get github.com/docker/docker/client
[Read the full Docker Engine Python SDK reference](https://docker-py.readthedocs.io/).
## View the API reference
You can
[view the reference for the latest version of the API](/engine/api/latest/)
or [choose a specific version](/engine/api/version-history/).
## Versioned API and SDK
The version of the Docker Engine API you should use depends upon the version of
your Docker daemon and Docker client.
The version of the Docker API you should use depends upon the version of your
Docker daemon and Docker client.
A given version of the Docker Engine SDK supports a specific version of the
Docker Engine API, as well as all earlier versions. If breaking changes occur,
@ -130,9 +124,8 @@ You can specify the API version to use, in one of the following ways:
Use the following guidelines to choose the SDK or API version to use in your
code:
- If you're starting a new project, use the
[latest version](/engine/api/latest/), but do specify the version you are
using. This helps prevent surprises.
- If you're starting a new project, use the latest version, but do specify the
version you are using. This helps prevent surprises.
- If you need a new feature, update your code use at least the oldest version
that supports the feature, and prefer the latest version you are able to use.
- Otherwise, continue to use the version that your code is already using.

6
engine/api/latest/index.html
View File

@ -1,6 +0,0 @@
---
---
<html>
<head><meta http-equiv="refresh" content="0;url=/engine/api/v{{ site.latest_stable_docker_engine_api_version }}/" /></head>
<body><p>Redirecting to the latest version of the Docker Engine API reference.</body>
</html>