DD 4.15: Dev Velocity and POS content updates (docker#16176)

aevesdocker · dvdksn · web-flow · commit 3fcd3c338f09 · 2022-12-01T15:26:08.000Z
* DD 4.15: Dev Velocity content updates

* fix broken links

* Changes from feedback

* POS virtiofs additions

* remove old known-issues content

* last edits

* Update _includes/beta.md

Co-authored-by: David Karlsson &lt;35727626+dvdksn@users.noreply.github.com&gt;

* Update desktop/settings/linux.md

Co-authored-by: David Karlsson &lt;35727626+dvdksn@users.noreply.github.com&gt;

* Update desktop/settings/windows.md

Co-authored-by: David Karlsson &lt;35727626+dvdksn@users.noreply.github.com&gt;

* Update desktop/settings/windows.md

* Update desktop/settings/mac.md

Co-authored-by: David Karlsson &lt;35727626+dvdksn@users.noreply.github.com&gt;
diff --git a/_includes/beta.md b/_includes/beta.md
@@ -1,7 +1,7 @@
-Beta features provide early access to future product functionality.
+Beta features provide access to future product functionality.
 These features are intended for testing and feedback only as they may change
-between releases without warning or can be removed entirely from a future
+between releases without warning or remove them entirely from a future
 release. Beta features must not be used in production environments.
-Docker does not offer support for beta features.
+Docker doesn't offer support for beta features. 
+
 
-For a list of current experimental features in the Docker CLI, see [Docker CLI Experimental features](https://github.com/docker/cli/blob/master/experimental/README.md).
diff --git a/_includes/desktop-experimental.md b/_includes/desktop-experimental.md
@@ -0,0 +1,3 @@
+On the **Experimental features** tab, you have the option to allow feature flags. These are features that Docker is currently experimenting with. This is switched on by default.
+
+These features are intended for testing and feedback only as they may change between releases without warning or remove them entirely from a future release. Docker doesn't offer support for experimental features.
diff --git a/desktop/settings/linux.md b/desktop/settings/linux.md
@@ -130,18 +130,6 @@ Type a JSON configuration file in the box to configure the daemon settings. For
 
 Click **Apply & Restart** to save your settings and restart Docker Desktop.
 
-## Beta Features
-
-{% include beta.md %}
-
-From the **Beta features** tab, you can sign up to the [Developer Preview program](https://www.docker.com/community/get-involved/developer-preview/){:target="_blank" rel="noopener" class="_"}.
-
-On the **Beta features** tab, you also have the option to allow feature flags, which are product features Docker is currently experimenting with. This is switched on by default.
-
-### Enable containerd
-
-Turns on the experimental containerd image store. This brings new features like namespaces and faster container startup performance by lazy-pulling images.
-
 ## Kubernetes
 
 Docker Desktop includes a standalone Kubernetes server, so that you can test
@@ -183,3 +171,21 @@ Use the **Extensions** tab to:
 - **Show Docker Extensions system containers**
 
 For more information about Docker extensions, see [Extensions](../extensions/index.md).
+
+## Features in development
+
+On the **Feature control** tab you can control your settings for **Beta features** and **Experimental features**.
+
+You can also sign up to the [Developer Preview program](https://www.docker.com/community/get-involved/developer-preview/){:target="_blank" rel="noopener" class="_"} from the **Features in development** tab.
+
+### Beta features
+
+{% include beta.md %}
+
+#### Enable containerd
+
+Turns on the experimental containerd image store. This brings new features like faster container startup performance by lazy-pulling images, and the ability to run Wasm applications with Docker.
+
+### Experimental features
+
+{% include desktop-experimental.md %}
diff --git a/desktop/settings/mac.md b/desktop/settings/mac.md
@@ -32,8 +32,7 @@ On the **General** tab, you can configure when to start Docker and specify other
 
 - **Use Virtualization framework**. Select to allow Docker Desktop to use the `virtualization.framework` instead of the `hypervisor.framework`. 
 
-- **Use gRPC FUSE for file sharing**. Clear this check box to use the legacy
-  osxfs file sharing instead.
+- **Choose file sharing implementation for your containers**. Choose whether you want to share files using **VirtioFS**, **gRPC FUSE**, or **osxfs**. The **VirtioFS** option is only available for macOS versions 12.5 and above. 
 
 - **Send usage statistics**. Select so Docker Desktop sends diagnostics,
   crash reports, and usage data. This information helps Docker improve and
@@ -163,30 +162,6 @@ Type a JSON configuration file in the box to configure the daemon settings. For
 
 Click **Apply & Restart** to save your settings and restart Docker Desktop.
 
-## Beta Features
-
-{% include beta.md %}
-
-On the **Beta features** tab, you also have the option to allow feature flags, which are product features Docker is currently experimenting with. This is switched on by default.
-
-### Enable VirtioFS
-
- Docker Desktop for Mac lets developers use a new experimental file-sharing implementation called [virtiofS](https://virtio-fs.gitlab.io/){: target='_blank' rel='noopener' class='_'}; the current default is gRPC-FUSE. virtiofs has been found to significantly improve file sharing performance on macOS. For more details, see our blog post [Speed boost achievement unlocked on Docker Desktop 4.6 for Mac](https://www.docker.com/blog/speed-boost-achievement-unlocked-on-docker-desktop-4-6-for-mac/){:target="_blank" rel="noopener" class="_"}.
-
-To enable virtioFS:
-
-1. Verify that you are on the following macOS version:
-   - macOS 12.2 or later (for Apple Silicon)
-   - macOS 12.3 or later (for Intel)
-
-2. Select **Enable VirtioFS accelerated directory sharing** to enable virtioFS.
-
-3. Click **Apply & Restart**.
-
-### Enable containerd
-
-Turns on the experimental containerd image store. This brings new features like namespaces and faster container startup performance by lazy-pulling images.
-
 ## Kubernetes
 
 Docker Desktop includes a standalone Kubernetes server, so that you can test
@@ -228,3 +203,21 @@ Use the **Extensions** tab to:
 - **Show Docker Extensions system containers**
 
 For more information about Docker extensions, see [Extensions](../extensions/index.md).
+
+## Features in development
+
+On the **Feature control** tab you can control your settings for **Beta features** and **Experimental features**.
+
+You can also sign up to the [Developer Preview program](https://www.docker.com/community/get-involved/developer-preview/){:target="_blank" rel="noopener" class="_"} from the **Features in development** tab.
+
+### Beta features
+
+{% include beta.md %}
+
+#### Enable containerd
+
+Turns on the experimental containerd image store. This brings new features like faster container startup performance by lazy-pulling images, and the ability to run Wasm applications with Docker.
+
+### Experimental features
+
+{% include desktop-experimental.md %}
diff --git a/desktop/settings/windows.md b/desktop/settings/windows.md
@@ -203,20 +203,6 @@ Type a JSON configuration file in the box to configure the daemon settings. For
 
 Click **Apply & Restart** to save your settings and restart Docker Desktop.
 
-## Beta features
-
-{% include beta.md %}
-
-
-On the **Beta features** tab, you also have the option to allow feature flags, which are product features Docker is currently experimenting with. This is switched on by default.
-
-From the **Beta features** tab, you can sign up to the [Developer Preview program](https://www.docker.com/community/get-involved/developer-preview/){:target="_blank" rel="noopener" class="_"}.
-
-
-### Enable containerd
-
-Turns on the experimental containerd image store. This brings new features like namespaces and faster container startup performance by lazy-pulling images.
-
 ## Kubernetes
 
 > **Note**
@@ -253,7 +239,7 @@ when an update becomes available. After downloading the update, click
 **Apply and Restart** to install the update. You can do this either through the
 Docker menu or in the **Updates** section in the Docker Dashboard.
 
-## Extensions 
+## Features in development
 
 Use the **Extensions** tab to:
 
@@ -262,3 +248,21 @@ Use the **Extensions** tab to:
 - **Show Docker Extensions system containers**
 
 For more information about Docker extensions, see [Extensions](../extensions/index.md).
+
+## Feature control 
+
+On the **Feature control** tab you can control your settings for **Beta features** and **Experimental features**.
+
+You can also sign up to the [Developer Preview Program](https://www.docker.com/community/get-involved/developer-preview/){:target="_blank" rel="noopener" class="_"} from the **Features in development** tab.
+
+### Beta features
+
+{% include beta.md %}
+
+#### Enable containerd
+
+Turns on the experimental containerd image store. This brings new features like faster container startup performance by lazy-pulling images, and the ability to run Wasm applications with Docker.
+
+### Experimental features
+
+{% include desktop-experimental.md %}
diff --git a/desktop/troubleshoot/known-issues.md b/desktop/troubleshoot/known-issues.md
@@ -10,20 +10,6 @@ title: Known issues for Docker Desktop on Mac
 <div class="tab-content">
 <div id="tab3" class="tab-pane fade in active" markdown="1">
 <br>
-* The following issues are seen when using the `virtualization.framework` experimental feature:
-
-  * Some VPN clients can prevent the VM running Docker from communicating with the host, preventing Docker Desktop starting correctly. See [docker/for-mac#5208](https://github.com/docker/for-mac/issues/5208).
-
-    This is an interaction between `vmnet.framework` (as used by `virtualization.framework`) and the VPN clients.
-
-  * Some container disk I/O is much slower than expected. See [docker/for-mac#5389](https://github.com/docker/for-mac/issues/5389){:target="_blank" rel="noopener" class="_"}. Disk flushes are particularly slow due to the need to guarantee data is written to stable storage on the host. We have also observed specific performance problems when using the `virtualization.framework` on Intel chips on MacOS Monterey.
-
-    This is an artifact of the new `virtualization.framework`. 
-
-  * The Linux Kernel may occasionally crash. Docker now detects this problem and pops up an error dialog offering the user the ability to quickly restart Linux.
-
-    We are still gathering data and testing alternate kernel versions.
-
 * IPv6 is not (yet) supported on Docker Desktop.
 
 * On Apple silicon in native `arm64` containers, older versions of `libssl` such as `debian:buster`, `ubuntu:20.04`, and `centos:8` will segfault when connected to some TLS servers, for example, `curl https://dl.yarnpkg.com`. The bug is fixed in newer versions of `libssl` in `debian:bullseye`, `ubuntu:21.04`, and `fedora:35`.
diff --git a/release-lifecycle.md b/release-lifecycle.md
@@ -14,10 +14,23 @@ This page details Docker's product release lifecycle and how Docker defines each
 
 | Lifecycle stage  | Customer availability | Support availability | Limitations | Retirement |
 | --- | --- | ---- | ---| ---|
+|[Experimental](#experimental)| Limited availability | Community support |Software may have limitations, bugs and/or stability concerns | Can be discontinued without notice |
 |[Beta](#beta) | All or those involved in a Beta Feedback Program | Community support | Software may have limitations, bugs and/or stability concerns | Can be discontinued without notice |
 | [Early Access (EA)](#early-access-ea) | All or those involved in an Early Access Feedback Program | Full | Software may have limitations, bugs and/or stability concerns.  These limitations will be documented. | Follows [retirement process](#retirement-process) |
 | [General Availability (GA)](#general-availability-ga) | All | Full | Few or no limitations for supported use cases | Follows [retirement process](#retirement-process) |
 
+### Experimental
+
+Experimental offerings are features that Docker is currently experimenting with. Customers who access experimental features have the opportunity to test, validate, and provide feedback on future functionality. This helps us focus our efforts on what provides the most value to our customers.
+
+**Customer availability:** Availability of experimental features is limited. A portion of users may have access to none, one or many experimental features. 
+
+**Support:** Support for Experimental features is best effort via Community support channels and forums.
+
+**Limitations:** Experimental features may have potentially significant limitations such as functional limitations, performance limitations, and API limitations. Features and programmatic interfaces may change at any time without notice.
+
+**Retirement:** During the experimental period, Docker will determine whether to continue an offering through its lifecycle. We reserve the right to change the scope of or discontinue an Experimental product or feature at any point in time without notice, as outlined in our [Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement).
+
 ### Beta
 
 Beta offerings are initial releases of potential future products or features. Customers who participate in our beta programs have the opportunity to test, validate, and provide feedback on future functionality. This helps us focus our efforts on what provides the most value to our customers.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+On the Experimental features tab, you have the option to allow feature flags. These are features that Docker is currently experimenting with. This is switched on by default.`
	`2`	`+`
	`3`	`+These features are intended for testing and feedback only as they may change between releases without warning or remove them entirely from a future release. Docker doesn't offer support for experimental features.`