Rearrange limitations and prerequisites
@@ -81,10 +81,12 @@ Integration tests can read the following system properties to obtain information
Start a Liberty server in a local container using the Dockerfile that you provide. An alternative to the `devc` goal is to specify the `dev` goal with the `-Dcontainer` option.
-You need to install the Docker runtime (e.g. Docker Desktop) locally to use this Maven goal. The installed Docker Client and Engine versions must be 18.03.0 or higher.
-
When dev mode runs with container support, it builds a container image and runs the container. You can examine the commands that it uses to build and run the container by viewing the console output of dev mode. Additionally, it still provides the same features as the `dev` goal. It monitors files for changes and runs tests either automatically or on demand. This mode also allows you to attach a debugger to work on your application. You can review the logs generated by your server in the Liberty directory in your project e.g. target/liberty/wlp/usr/servers/defaultServer/logs.
+###### Prerequisites
+
+You need to install the Docker runtime locally (Docker Desktop on macOS or Windows, or Docker on Linux) to use this Maven goal. The installed Docker Client and Engine versions must be 18.03.0 or higher.
+
###### Dockerfile
Your project must have a Dockerfile to use dev mode in container mode. A sample Dockerfile is shown in [Building an application image](https://github.com/openliberty/ci.docker/#building-an-application-image). The parent image must be one of the [Open Liberty container images](https://github.com/openliberty/ci.docker/#container-images), or an image using Linux with Open Liberty configured with the same paths as the Open Liberty container images.
@@ -115,17 +117,12 @@ While dev mode is running in container mode, perform the following in the comman
* To rebuild the Docker image and restart the container, type `r` and press Enter.
* To exit dev mode, press `Control-C`, or type `q` and press Enter.
-###### Limitations
+###### Linux Limitations
-The following limitations apply.
+The following limitations apply to Linux:
-- Platform limitations:
- - Supported on macOS and Windows with Docker Desktop installed.
- - Supported on Linux. Note the following.
- - In dev mode the Open Liberty server runs in the container on the UID (user identifier) of the current user. This is so that the server can access the configuration files from your project and you can access the Open Liberty log files. Outside of dev mode the Open Liberty server will run on the UID specified in the Docker image.
- - Use of editors like `vim`: when you edit a configuration file with `vim` it will delete the file
- and rewrite it when you save. This necessitates a container restart. To avoid the restart edit your
- .vimrc file and add the line `set backupcopy=yes`
+* In dev mode, the Open Liberty server runs in the container on the UID (user identifier) of the current user. This is so that the server can access the configuration files from your project and you can access the Open Liberty log files. Outside of dev mode, the Open Liberty server will run on the UID specified in the Docker image.
+* Use of editors like `vim`: when you edit a configuration file with `vim` it will delete the file and rewrite it when you save. This necessitates a container restart. To avoid the restart edit your .vimrc file and add the line `set backupcopy=yes`
###### Examples
