Moving experimental

Signed-off-by: Mary Anthony <mary@docker.com>

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**']
 

experimental/EXPERIMENTAL.md

@@ -1,12 +1,8 @@
-page_title: Overview of Experimental Features
+# Docker Experimental Features 
-page_keywords: experimental, Docker, feature
 
-# Experimental Features in this Release 
+	This page contains a list of features in the Docker engine which are
-
+experimental. Experimental features are **not** ready for production. They are
-This page contains a list of features in the Docker engine which are
+provided for test and evaluation in your sandbox environments.  
-experimental as of the current release. 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).  

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

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

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