Update README.md

README.md

@@ -21,12 +21,12 @@ To add a dev container definition in your project, you can either:
 
 ## Trying a definition
 
-If you want to play with a definition,
+If you want to try out a definition before chooisng one:
 
-1. Browse the contents of the  `containers` in this repository and pick one. Check out the `README` to see if there are any manual steps required before proceeding.
-3. Clone this repository or copy the contents of the folder to your machine.
-4. Run the **Remote-Containers: Open Folder in Container...** command in VS Code.
-5. Select the root of the definition folder in the "open" dialog (**not** the `test-project` folder if present).
+1. Browse the contents of the  `containers` folder in this repository and pick one. Check out the `README` to see if there are any manual setup steps you should be aware of before continuing.
+2. Clone this repository locall.
+3. Start VS Code, press <kbd>F1</kbd>, and run the **Remote-Containers: Open Folder in Container...** command.
+4. Select the root of the definition folder in the "open" dialog (**not** the `test-project` folder if present).
 
 Many definitions include a `test-project` with a sample and/or launch settings in the `.vscode` folder that you can use to see the dev container in action. See the definition's `README` for details.
 
@@ -42,19 +42,15 @@ Beyond the advantages of having your team use a consistent environment and tool-
 - `container-templates` - Contains templates for creating your own container definitions for your project or to [contribute back](CONTRIBUTING.md#contributing-dev-container-definitions).
 - `repository-containers` - Dev container definitions for working on a cloned copy of specific, public source code repository (rather than general purpose).
 
-## Common Questions
+### Common Questions
 
-### Can I just reuse an existing container image or Docker configuration?
+#### Can I just reuse an existing container image or Docker / Docker Compose configuration?
 
-Absolutely! If you want to use an existing Dockerfile as a starting point, run **Remote-Containers: Create Container Configuration File...** from the command pallette (Cmd/Ctrl+Shift+P). You'll be prompted to select a Dockerfile or you can opt to use a base image instead and customize from there.
+Yes! If you want to use an existing Dockerfile as a starting point, run **Remote-Containers: Create Container Configuration File...** from the command pallette (Cmd/Ctrl+Shift+P). You'll be prompted to select a Dockerfile or Docker Compose file and customize from there. If you prefer, you can also you can start up the container any way you see fit and [attach to it](https://aka.ms/vscode-remote/containers/attach) instead.
 
-You can also check out the [existing Dockerfile](containers/docker-existing-dockerfile) and [existing Docker Compose](containers/docker-existing-docker-compose) definitions for an example `devcontainer.json` . If none of these options meet your needs, you can start up the container any way you see fit and [attach to it](https://aka.ms/vscode-remote/containers/attach) instead.
+#### What is the goal of `devcontainer.json`?
 
-### What is the goal of `devcontainer.json`?
-
-The intent of `devcontainer.json` is conceptually similar to VS Code's `launch.json` for debugging, but designed to launch (or attach to) your development container instead. At its simplest, all you need to do is add a `.devcontainer/devcontainer.json` file to your project and reference an image, `Dockerfile`, or `docker-compose.yml` and a few properties.
-
-Check out the `container-templates` folder for simple starter templates. The definitions in the `containers` folder can be used as-is or as samples for how to modify your existing config to support different scenarios. From there, you can [alter your configuration](https://aka.ms/vscode-remote/containers/folder-setup) to install additional tools like Git in the container, automatically install other extensions, expose additional ports, set runtime arguments, and more.
+The intent of `devcontainer.json` is similar to `launch.json` for debugging, but designed to launch (or attach to) a development container instead. At its simplest, all you need to do is add a `.devcontainer/devcontainer.json` file to your project that references an image, `Dockerfile`, or `docker-compose.yml`, and a few properties. You can [adapt it for use](https://aka.ms/vscode-remote/containers/folder-setup) in a wide variety of situations.
 
 ## Contributing & Feedback