diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 7ac8066d1b..4fe1d83628 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -27,11 +27,6 @@ pages: - ['index.md', 'About', 'Docker'] - ['introduction/understanding-docker.md', 'About', 'Understanding Docker'] - ['release-notes.md', 'About', 'Release notes'] -# Experimental -- ['experimental/experimental.md', 'About', 'Experimental Features'] -- ['experimental/plugin_api.md', '**HIDDEN**'] -- ['experimental/plugins_volume.md', '**HIDDEN**'] -- ['experimental/plugins.md', '**HIDDEN**'] - ['reference/glossary.md', 'About', 'Glossary'] - ['introduction/index.md', '**HIDDEN**'] diff --git a/docs/sources/experimental/experimental.md b/experimental/EXPERIMENTAL.md similarity index 58% rename from docs/sources/experimental/experimental.md rename to experimental/EXPERIMENTAL.md index b0d72b90b0..37e9baf06e 100644 --- a/docs/sources/experimental/experimental.md +++ b/experimental/EXPERIMENTAL.md @@ -1,12 +1,8 @@ -page_title: Overview of Experimental Features -page_keywords: experimental, Docker, feature +# Docker Experimental Features -# Experimental Features in this Release - -This page contains a list of features in the Docker engine which are -experimental as of the current release. Experimental features are **not** ready -for production. They are provided for test and evaluation in your sandbox -environments. + This page contains a list of features in the Docker engine which are +experimental. Experimental features are **not** ready for production. They are +provided for test and evaluation in your sandbox environments. The information below describes each feature and the Github pull requests and issues associated with it. If necessary, links are provided to additional @@ -15,6 +11,8 @@ please feel free to provide any feedback on these features you wish. ## Install Docker experimental +Unlike the regular Docker binary, the experimental channels is built and updated nightly on https://experimental.docker.com. From one day to the next, new features may appear, while existing experimental features may be refined or entirely removed. + 1. Verify that you have `wget` installed. $ which wget @@ -49,3 +47,8 @@ please feel free to provide any feedback on these features you wish. * [Support for Docker plugins](plugins.md) * [Volume plugins](plugins_volume.md) +## How to comment on an experimental feature + +Each feature's documentation includes a list of proposal pull requests or PRs associated with the feature. If you want to comment on or suggest a change to a feature, please add it to the existing feature PR. + +Issues or problems with a feature? Inquire for help on the `#docker` IRC channel or in on the [Docker Google group](https://groups.google.com/forum/#!forum/docker-user). \ No newline at end of file diff --git a/docs/sources/experimental/plugin_api.md b/experimental/plugin_api.md similarity index 97% rename from docs/sources/experimental/plugin_api.md rename to experimental/plugin_api.md index 6454fc2a97..ad83ffd0a5 100644 --- a/docs/sources/experimental/plugin_api.md +++ b/experimental/plugin_api.md @@ -1,7 +1,3 @@ -page_title: Plugin API documentation -page_description: Documentation for writing a Docker plugin. -page_keywords: docker, plugins, api, extensions - # Experimental: Docker Plugin API Docker plugins are out-of-process extensions which add capabilities to the diff --git a/docs/sources/experimental/plugins.md b/experimental/plugins.md similarity index 94% rename from docs/sources/experimental/plugins.md rename to experimental/plugins.md index dbcb70ce67..0b7ca42a2c 100644 --- a/docs/sources/experimental/plugins.md +++ b/experimental/plugins.md @@ -1,6 +1,3 @@ -page_title: Experimental feature - Plugins -page_keywords: experimental, Docker, plugins - # Experimental: Extend Docker with a plugin You can extend the capabilities of the Docker Engine by loading third-party diff --git a/docs/sources/experimental/plugins_volume.md b/experimental/plugins_volume.md similarity index 94% rename from docs/sources/experimental/plugins_volume.md rename to experimental/plugins_volume.md index 399dda71e3..fe2ab0dc45 100644 --- a/docs/sources/experimental/plugins_volume.md +++ b/experimental/plugins_volume.md @@ -1,6 +1,3 @@ -page_title: Experimental feature - Volume plugins -page_keywords: experimental, Docker, plugins, volume - # Experimental: Docker volume plugins Docker volume plugins enable Docker deployments to be integrated with external